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Abstract 


Python este un limbaj de programare puternic şi uşor de învăţat. Are structuri de date de nivel înalt puternice şi o 
simplă, dar eficientă, abordare a programării orientate pe obiect. 


Sintaxa elegantă şi natura sa interpretată, fac din Python un limbaj ideal pentru elaborarea de script-uri şi dez- 
voltarea rapidă de aplicaţii, în multe domenii, pe majoritatea platformelor. 


Interpretorul Python şi biblioteca standard sunt oferite sub formă de surse sau compilate pentru majoritatea plat- 
formelor existente, pe site-ul Python, http: //www.python.org/, si pot fi distribuite gratuit. Pe acelaşi site 
puteţi găsi distribuții Python şi module scrise de alti programatori, precum şi documentaţie adițională. 


Interpretorul Python este uşor de extins prin adăugarea de noi funcţii şi tipuri de date implementate în C sau C++ 
(sau alte limbaje apelabile din C). Python poate fi folosit şi drept limbaj de extensie pentru aplicaţii. 


Acest material informează cititorul despre conceptele de bază şi capabilitățile sistemului şi limbajului Python. Ar 
fi de preferat să aveţi la îndemână un interpretor Python pentru a experimenta, dar toate exemplele cuprinse în 
acest material pot fi înţelese fără a fi imperativă prezenţa interpretorului. 


Pentru o descriere a obiectelor şi modulelor standard, consultaţi documentul Python Library Reference. Documen- 
tul Python Reference Manual dă o definiţie mai exactă a limbajului. Dacă doriţi să extindeti sau să implementati 
limbajul Python într-o aplicaţie cu ajutorul C++ consultaţi documentul Extending and Embedding the Python 
Interpreter şi Python/C API Reference. Există şi cărţi care acoperă limbajul Python în toată complexitatea sa. 


Acest tutorial nu încearcă să acopere toate facilităţile Python-ului, sau măcar cele mai folosite dintre ele. În 
schimb, vă prezintă cele mai interesante şi importante facilităţi, şi vă va da o idee despre modul de funcţionare al 
limbajului. 


După ce veţi citi acest tutorial, veţi putea citi şi scrie module sau programe Python, şi veţi fi pregătiţi să ivatati mai 
multe despre diferitele biblioteci incluse în distribuţia Python, descrise în documentul Python Library Reference. 
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CAPITOLUL 
UNU 


De ce Python ? 


Dacă ati construit vreodată un shell complex, probabil cunoaşteţi senzaţia: vreţi să adăugaţi încă o facilitate, 
dar este deja atât de lent, atât de mare, atât de complicat; sau adăugarea facilitatii implică un apel de funcţie de 
sistem, sau altă funcţie care nu este accesibilă decăt din C. De obicei problema pe care o aveţi de rezolvat nu 
este suficient de serioasă astfel încât să merite să rescrieti shell-ul în C; poate că rezolvarea problemei necesită 
folosirea şir-urilor de lungime variabilă, sau a listelor sortate de nume de fişiere, lucruri accesibile într-un shell, 
dar care necesită multă muncă pentru a fi implementate în C; sau poate că nu sunteţi suficient de familiarizat cu 
limbajul C. 


Să considerăm o altă situaţie: presupunem că trebuie să lucraţi cu anumite biblioteci C, şi ciclul obişnuit de scriere 
- compilare - testare - recompilare este prea lent. Vreti să dezvoltați mult mai rapid software. E posibil sá fi scris 
un program care poate folosi un limbaj de extensie, şi nu vreţi să dezvoltați un alt limbaj pentru asta, să scrieţi şi 
să verificaţi de erori un interpretor pentru acest limbaj, pentru ca apoi să-l adăugaţi la aplicaţia dumneavoastră. 


În aceste cazuri Python este limbajul de care aveţi nevoie. Este simplu de folosit, dar este un limbaj de programare 
adevărat, oferind posibilitatea unei mai bune structurări, şi un suport mai bun pentru programe mari decât oferă un 
shell. Pe de altă parte dispune de o mult mai bună verificare a erorilor decât C-ul, şi fiind un limbaj de nivel foarte 
înalt, dispune de tipuri de date de nivel înalt cum ar fi tablouri sau dicţionare foarte flexibile, a căror implementare 
în C ar lua programatorului zile. Datorită caracterului general al tipurilor de date Python poate fi aplicat într-o 
arie mult mai largă de probleme decât AWK sau PERL. Cu toate astea, multe lucruri se realizează la fel de uşor în 
Python ca şi în aceste limbaje. 


Python permite divizarea programelor dumneavoastră în module care pot fi folosite apoi în alte programe Python. 
Dispune de o colecţie vastă de module standard de la care puteţi porni în construirea programului dumneavoastră, 
sau pentru a învăţa programarea în Python. 


Există de asemenea module încorporate care oferă facilităţi pentru sistemul de intrări - ieşiri (I/O), apeluri de 
sistem, sockets, şi chiar interfeţe pentru sisteme de interfatare grafică utilizator (GUI) precum TK. 


Python este un limbaj interpretat, care vă poate accelera munca în timpul procesului de dezvoltare, ne mai fiind 
nevoit să compilati codul de fiecare data. Interpretorul poate fi folosit interactiv, ceea ce vă permite să testati 
foarte uşor anumite facilităţi ale limbajului, să scrieţi imediat programe dispensabile, sau să testati anumite funcţii 
înainte de a le folosi în programul dumneavoastră. Este foarte uşor de folosit şi drept calculator de birou. 


Python permite scrierea unor programe foarte compacte şi uşor de citit. Programele scrise în Python sunt mult 
mai mici decat echivalentele în C sau C++ pentru că: 

e tipurile de date de nivel înalt vă permit să realizaţi operaţii complexe într-o singură instrucțiune; 

e gruparea instrucţiunilor este dată de paragrafare în loc de blocuri begin/end sau de acolade; 

e nu este necesară declararea variabilelor. 
Python este extensibil: dacă aveţi cunoştinţe de C puteţi foarte uşor sa adăugaţi o nouă funcţie sau un modul, 
fie pentru a efectua operaţii la viteză maximă, fie pentru a lega programe Python la biblioteci disponibile numai 


în format binar (biblioteci grafice). Puteţi de exemplu să adăugaţi interpretorul Python într-o aplicaţie C şi să îl 
folosiţi ca un limbaj de comandă sau de extensie pentru acea aplicaţie. 


Numele limbajului provine de la emisiunea BBC “Monthy Python's Flying Circus” (Circul zburător al şarpelui 
Monty) şi nu are nici o legătură cu disgratioasele reptile. Referinţe la Monty Python în documentaţia ce urmează 


nu numai că sunt permise, sunt chiar încurajate! 


Acum ca aveţi o idee despre Python, poate doriţi să îl examinati mai în detaliu. Din moment ce cea mai bună 
metodă de a invata un limbaj de programare este utilizarea acestuia, sunteţi şi dumneavoastră invitaţi să o faceţi. 


În urmatorul capitol este explicată utilizarea interpretorului. Informaţiile ce urmează pot părea banale, dar sunt 
esenţiale pentru testarea exemplelor ce vor urma. 


Cealaltă parte a tutorialului prezintă diferite facilitati ale limbajului Python. Această prezentare este bogată in 
exemple, începând cu expresii simple, instrucţiuni, tipuri de date şi terminând cu funcţii, module şi concepte 
avansate cum ar fi tratarea excepțiilor şi clase definite de utilizator. 
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CAPITOLUL 
DOI 


Utilizarea interpretorului Python 


2.1  Invocarea interpretorului 


Interpretorul Python este deobicei instalat în ‘/usr/local/bin/python’ pe maşinile unde există această cale. În lista 
cu directoarele de sistem a UNIX introduceţi calea ‘/usr/local/bin’ pentru a putea porni interpretorul cu comanda : 


python 


Din moment ce directorul în care este instalat interpretorul poate fi modificat la instalare şi alte căi sunt posibile. 
Vorbiti cu administratorul dumneavoastră de sistem înainte de a lua o decizie în privinţa directorului de instalare. 
(Ex: ‘/usr/local/python’ este o alternativă foarte populară). 


Tastarea unui caracter de sfârşit de fişier (Control-D pe UNIX, sau Control-Z pe DOS sau Windows) în 
timpul prompt-ului principal determină oprirea execuţiei interpretorului cu cod de ieşire zero. Dacă acest lucru nu 
funcţionează încercaţi comenzile: “import sys; sys.exit()’. 


Facilitatile de editare în linie de comandă ale interpretorului nu sunt deloc deosebite. Pe sisteme UNIX, în timpul 
instalării Python, puteţi activa opţiunea de suport a bibliotecii GNU de editare în linie de comandă. Pentru a 
vedea dacă această opţiune este activată, tastati combinaţia de taste Cont rol-P la primul prompt Python. Daca 
auziţi un sunet, aveţi activată opţiunea despre care vorbeam mai sus (consultaţi Anexa A, pentru o scurtă lista 
de combinaţii de taste foarte utile). Dacă nu se întamplă nimic sau este afişat ^P, opţiunea de editare a liniei de 
comandă nu este activată, deci nu veţi putea decât să ştergeţi (BACKSPACE) sau să introduceţi noi caractere în 
linie. 


Interpretorul funcţionează asemanător shell-ului UNIX: când este apelat cu intrarea standard conectată la un dis- 
pozitiv TTY, citeşte şi execută comenzi interactiv. Când este apelat cu un parametru, reprezentând un nume de 
fişier, citeşte şi execută un script (program) din acel fişier. 


> 


O a treia modalitate de a porni interpretorul este “python -c comandă [arg] ...’ care execută instructi- 
unea/instructiunile din comandă, analog opțiunii -c a shell-ului. Din moment ce o comandă poate conţine 
spaţii sau alte caractere utilizate de shell (ca separatori de parametrii de exemplu) este bine să introduceţi co- 
manda/comenzile între ghilimele. 


Observati că există o diferenţă între “python file’ şi python <file’. În primul caz, datele de intrare ale 
programului sunt oferite de fişier. Din moment ce acest fişier a fost deja citit pană la capăt înainte de începerea 
programului, programul va întâlni sfârşit de fişier imediat. În al doilea caz (cel mai interesant şi cel mai folosit) 
datele de intrare sunt oferite de orice fişier sau dispozitiv conectat la intrarea standard a interpretorului Python. 


Când este rulat un script, este câteodată folositor ca după rularea script-ului să se intre în modul interactiv. Acest 
lucru se realizează foarte simplu folosind parametrul -i înainte de numele fişierului în care se află script-ul. Evident 
că acest parametru nu va funcţiona dacă script-ul este citit de la intrarea standard. 


2.1.1 Transmiterea argumentelor 


Atunci când după parametrul care reprezintă fişierul în care se află script-ul, interpretorului i se mai transmit şi 
alti parametrii, acestia vor fi transmişi mai departe script-ului prin intermediul variabilei sys . argv, variabilă 


ce conţine o listă (vector) de şiruri de caractere. Atunci când în loc de numele fişierului se transmite * _” (adică 
intrarea standard), sys .argv [0] =’_’. Când este folosită comanda -c, sys.argv[0] =”-c”. Parametrii de 
după -e comandă nu sunt consideraţi parametrii ai interpretorului, ci sunt scrişi în sys . argv pentru a fi folosiţi 
de comandă. 


2.1.2 Modul interactiv 


Când comenzile sunt citite de la un TTY, se spune că interpretorul se află în modul interactiv. În acest mod 
există două prompt-uri. Prompt-ul principal (de obicei “>>> ”) şi promptul secundar (de obicei *. .. ”) folosit 
pentru continuarea liniilor. Interpretorul afişează imediat după pornire un mesaj de întâmpinare în care se specifică 
versiunea şi autorii Python-ului, urmate de primul prompter : 


python 

Python 1.5.2b2 (#1, Feb 28 1999, 00:02:06) [GCC 2.8.1] on sunos5 
Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam 

>>> 


Liniile de continuare sunt folosite la introducerea unei constructii multilinie. De exemplu: 


>>> pamantul_este_plat = 1 
>>> if pamantul_este_plat: 
print "Ai grija sa nu cazi!" 


Ai grija sa nu cazi! 


2.2 Interpretorul şi mediul in care rulează 


2.2.1 Tratarea erorilor 


Cand are loc o eroare, interpretorul afişează un mesaj de eroare şi starea stivei în momentul respectiv. În modul 
interactiv revine la prompt-ul principal. Atunci când intrările provin dintr-un fişier, interpretorul se opreşte cu un 
cod de eroare diferit de zero după ce a afişat starea stivei.(Exceptiile tratate nu sunt erori în acest context). Unele 
erori sunt inevitabil fatale şi cauzează terminarea anormală cu cod de ieşire diferit de zero (Ex: lipsa de memorie). 
Toate mesajele de eroare sunt scrise la ieşirea pentru erori (standard error stream). lesirile provenite din execuţia 
comenzilor sunt scrise la ieşirea standard. 


Dacă se apasă caracterul de întrerupere (Control-C, DEL) în primul prompt sau în cel secundar, comanda 
scrisă este pierdută revenindu-se la promptul principal. Intreruperea unei comenzi în timpul execuţiei creează o 
excepţie de tip Keyboard Interrupt, care poate fi tratată într-o instrucțiune try. 


2.2.2 Script-uri Python executabile 


Pe sisteme UNIX,BSD, scripturile Python pot fi făcute direct executabile, la fel ca scripturile de shell, punând linia 


$! /usr/bin/env python 


(presupunem că interpretorul se află în variabila de sistem PATH a utilizatorului) la începutul script-ului si apoi 
transformând fişierul în executabil. Caracterele ‘’ 4!” ” trebuie să fie neapărat primele două caractere din fişier. 


Observaţie: Caracterul “+” este folosit pentru comentarii in Python. 


Scriptul poate fi făcut executabil utilizâd comanda chmod : 


4 Capitolul 2. Utilizarea interpretorului Python 


$ chmod +x myscript.py 


2.2.3 Codificarea codului sursa 


În fisierele sursă Python se pot utiliza şi alte codificări in afară de ASCII.Pentru a realiza acest lucru cel mai bine 
este să puneţi imediat dupa #! încă un caracter de comentariu de linie p[entru a defini codificarea fişierului sursă : 


4 -»- coding: \code{encoding} -x- 


Dupa această declaraţie toate caracterele din codul sursă vor fi tratate ca fiind codificate in encoding si este posibil 
să se scrie şiruri de caractere Unicode direct in codificarea aleasa. Lista posibilelor codificări o puteţi găsi in 
Python Library Reference, secţiunea codecs. 


De exemplu, pentru a scrie cu caractere Unicode ce includ simbolul valutar Euro, se poate utiliza codificarea 
ISO-8859-15, cu valoarea 164 pentru simbolul valutar Euro. Acest script va tipări valoarea 8364 (codul Unicode 
pentru simbolul Euro) si apoi iese : 


4 -»- coding: iso-8859-15 —x-— 


currency = u" " 
print ord(currency) 


Daca editorul folosit poate salva fişierul in format UTF-8 cu un UTF-8 byte order mark (aka BOM) puteţi 
folosi acest lucru in locul unei declaratii de codificare. IDLE accepta aceasta posibilitate daca se seteaza 
Option/General/Default Sorce Encoding/UTF-8. Observatie: Acest lucru nu este recunoscut de 
versiunile Python mai vechi de 2.2, precum si de sistemele de operare cu fisierele script ce incep cu #! (sistemele 
UNIX). 


Utilizad UTF-8 (cu declaratie de codificare, sau direct), caracterele utilizate se multitudinea de limbi de de glob 
pot apărea simultan in şiruri literale şi comentarii. Nu este acceptată utilizarea caracterelor non ASCII pentru 
numele de identificatori. Pentru a reprezenta corect caracterele, editorul cu care lucrati ar trebui să recunoască că 
un fişier este scris în UTF-8, şi trebuie să folosească un font care să contina toate caracterele din fişsier. 


2.2.4 Fisierul de initializare al modului interactiv 


Când folosiţi Python în modul interactiv, poate fi foarte folositor să aveţi câteva comenzi care să se execute 
automat de fiecare dată când este pornit interpretorul. Puteţi realiza acest lucru creând o variabilă de sistem 
cu numele PYTHONSTARTUP care să conţină numele unui fişier în care să aveţi comenzile, care doriţi să fie 
executate la pornirea interpretorului. Această procedură este similară, facilitatii “.profile” de pe sistemele UNIX. 
Acest fişier de initializare este interpretat numai când este pornit interpretorul Python în mod interactiv. Fişierul 
nu este interpretat nici când interpretorul Python are ca intrare un fişier, nici când sursa explicită a comenzilor este 
‘/devitty’. Acest fişier este executat în acelaşi cadru în care se execută şi comenzile interactive. În acest fişier pot 
fi schimbate chiar şi prompt-urile sys . ps1 sau sys.ps2. 


Dacă doriţi să executaţi şi alte fişiere de initializare, din directorul curent trebuie să adăugaţi câteva linii la 
fişierul principal de initializare, utilizând un cod ca acesta “if os.path.isfile(’.pythonre.py’) : 
execfile(” .pythonrc.py' )’ 


Dacă doriţi sá folosiţi acest fişier de initializare, într-un program, trebuie să specificaţi acest lucru explicit în cadrul 
programului astfel: 


2.2. Interpretorul şi mediul în care rulează 5 


import os 

filename = os.environ.get (’PYTHONSTARTUP’ ) 

if filename and os.path.isfile(filename): 
xecfile (filename) 


Capitolul 2. Utilizarea interpretorului Python 


CAPITOLUL 
TREI 


O scurtă introducere în Pyihon 


În exemplele ce urmează, intrările şi ieşirile vor fi deosebite prin prezenţa sau absenţa prompt-urilor (princi- 
pal ‘>>> ” sau secundar ‘... ”). Pentru a testa un exemplu trebuie să scrieţi linia ce apare imediat dupa 
prompt. Liniile care nu au caracterele ‘>>> ? sau ‘... > în fata sunt linii de ieşire, rezultate în urma 
comenzilor anterioare, sau a ultimei comenzi. Un prompt secundar, fără nimic după el, înseamnă că trebuie 
să introduceţi o linie goală. Acest procedeu este folosit pentru terminarea unui bloc de instrucţiuni (de tipul 


"begin! ...'end';(...)). 


Multe din exemplele din acest tutorial contin comentarii. În Python comentariile încep cu un caracter “+” şi se 
termină la sfârşitul liniei. Un comentariu poate apărea la sfârşitul unei linii, dar nu poate apărea în cadrul unui 


string. Un caracter ‘#’ în cadrul unui string nu reprezintă începutul unui comentariu ci doar un caracter ‘#’. lată 
câteva exemple: 


+ primul comentariu 


SPAM = 1 + si al doilea comentariu 
4 ... Si al treilea! 
STRING = "4 Acesta nu este un comentariu." 


3.1 Utilizarea Python-ului drept calculator de birou 


Să încercăm câteva comenzi simple Python. Pornifi interpretorul şi aşteptaţi să apară prompt-ul principal 
‘>>> ”.(Nu ar trebui să dureze prea mult). 


3.1.1 Numere 


Interpretorul funcţionează ca un simplu calculator: puteţi scrie o expresie, şi ca răspuns veţi primi rezultatul. 
Ordinea operaţiilor şi modul de parantezare sunt la fel ca în majoritatea limbajelor (ex: Pascal sau C). 


De exemplu: 


>>> 2+2 


>>> $ Acesta este un comentariu 
2+2 # Un comentariu pe aceiasi linie de cod 


>>> (50 - 5x 6) / 4 


>>> # Impartirea numerelor intregi are ca rezultat, de fapt, 
+ partea intreaga a rezultatului impartirii 
US 


>>> 7 / -3 


La fel ca în C, semnul egal (‘=’) este folosit la atribuire. Valoarea atribuită nu constituie o ieşire (nu este tipărită 
pe ecran): 


>>> latime = 20 

>>> inaltime = 5x9 
>>> latime * inaltime 
900 


O valoare poate fi atribuită simultan mai multor variabile: 


= y = z = 0 # x, y si z devin zero 


Există suport complet pentru virgulă mobilă. Operatorii care au operanzi de tipuri diferite vor converti operandul 
întreg în virgulă mobilă: 


>>> 3 x 3.75 / 1.5 
db 

>> OY 2 

355 


Numerele complexe sunt de asemenea suportate. Numerele imaginare sunt scrise cu sufixul ‘j’ sau ‘J’. Nu- 
merele complexe cu parte reală diferită de zero au forma * (real+imag3)” sau pot fi create folosind funcţia 
“complex (real, imag)’: 


> 
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>>> 13 x lJ 

(-1+03) 

>>> 13 * complex(0,1) 
(-1+03) 

>>> 3+13x3 

(3+33) 

>>> (3415) *3 

(9+33) 

>>> (1423) /(1+13) 
(1.5+0.53) 


Numerele complexe sunt intotdeauna reprezentate ca douá numere reale ín virgulá mobilá: partea realá si cea 
imaginară. Pentru a afla partea reală sau cea imaginară dintr-un număr complex z folosiţi z. real respectiv 


z.imag: 


>>> a=1.5+0.5]3 
>>> a.real 

PS 

>>> a.imag 

0.5 


Funcţiile de conversie la numere reale sau întregi nu funcţionează pentru numere complexe, neexistând o metodă 
matematică de a transforma un număr complex într-un numar real. Folosiţi funcţia abs (z) pentru a calcula 


modulul, sau z . real pentru a afla partea reală: 


>>> a=3.0+4.03 
>>> float (a) 
Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
TypeError: can’t convert complex to float; use e.g. abs (z) 
>>> a.real 
3.0 
>>> a.imag 
4.0 
>>> abs(a) # sqrt(a.real**2 + a.imagx*x*2) 
5:20. 
>>> 


În modul interactiv ultima valoare afişată este atribuită unei variabile _. Dacă folosiţi Python ca un calculator de 


birou este mult mai uşor să păstraţi continuitatea calculelor: 


>>> tax = 12.5 / 100 
>>> price 100.50 
>>> price * tax 
12.5625 

>>> price + 
113.0625 
>>> round(_, 2) 
113.06 

>>> 


Această variabilă trebuie tratată de utilizator ca având numai capacitatea de a fi citită, nu şi scrisă (READ-ONLY). 
Nu atribuiti valori acestei variabile, deoarece acest lucru înseamnă că veţi creea o variabilă nouă locală care va 


ascunde variabila implicită _ şi comportamentul său extraordinar. 


3.1. Utilizarea Python-ului drept calculator de birou 


3.1.2 Şiruri de caractere 


În afară de numere Python poate manipula şi şiruri de caractere, care pot(exista) avea mai multe forme. Pot fi 
incluse între apostroafe sau ghilimele: 


>>> 'omleta’ 

“omleta” 

>>> Sonal 

"n-a" 

>>> "n-a" 

"n-a 

>>> '"Da," a spus el.’ 
'"Da," a spus el.’ 

>>> "\"Da,\" a spus el." 
“ "Da," a spus el.’ 

>>> '"Nu," a spus ea.’ 
""Nu," a spus ea.’ 


Şirurile de caractere pot exista pe mai multe linii, separarea realizându-se prin secvenţa de control “An” indicând 
astfel ca linia următoare este continuarea logică a liniei curente : 


hello = "Acesta este un sir de caractere mai lung, ni 
care se intinde pe mai mai multe linii, exact ca in C.\n\ 
Observati ca spatiile de la inceputul liniei) 
au importanta." 


print hello 


De notat că rămâne necesar ca semnele de linie nouă să fie incluse în şir utilizând \n; linia nouă care urmează 
ultimului backslash este eliminată. Acest exemplu va afişa următoarele: 


Acesta este un sir de caractere mai lung, 
care se intinde pe mai mai multe linii, exact ca in C. 
Observati ca spatiile de la inceputul liniei au importanta. 


Dacă construim şirul de caractere ca un şir “raw”, atunci secvenţa \n nu se converteşte în linie nouă, dar backslesh- 
ul de la sfârşitul liniei şi caracterul de linie nouă din sursă sunt incluse în şir ca date. lată un exemplu : 


hello = r"Acesta este un sir de caractere mai lung, \n\ 
Care se intinde pe mai mai multe linii, exact ca in C." 


print hello 


va tipari: 


Acesta este un sir de caractere mai lung, \n\ 
care se intinde pe mai mai multe linii, exact ca in C. 


Sirurile de caractere pot exista şi între perechi de cate trei ghilimele sau apostroafe (""" sau 7 7 7). In acest caz 
nu aveţi nevoie de caracterele de control (ex: \n\) pentru a realiza separarea liniilor: 
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print wey 
Usage: thingy [OPTIONS] 
-h Display this usage message 


-H hostname Hostname to connect to 


are următoarea ieşire: 


Usage: thingy [OPTIONS] 
-h Display this usage message 
-H hostname Hostname to connect to 


Interpretorul afişează rezultatul operațiilor cu şiruri de caractere exact în forma specificată de utilizator atunci 
când a introdus sau definit şirurile respectiv: între ghilimele, cu ghilimele sau alte caractere ciudate, pentru a afişa 
valoarea exactă a şirului. Instrucţiunea print despre care vă vom vorbi mai încolo poate fi folosită pentru a afişa 
şiruri fără ghilimele şi caractere de control. 


Şirurile de caractere pot fi concatenate: 


>>> word = 'Help” + ‘A’ 

>>> word 

'HelpA’ 

>>> '<” + word*5 + '>” 

' <HelpAHelpAHelpAHelpAHelpA>’ 


Două şiruri de caractere scrise unul lângă altul sunt concatenate. Prima linie din exemplul de mai sus poate fi 
rescrisă astfel: “word = ’Help”A’’. Acest lucru nu merge decât pentru şiruri explicite de caractere, nu pentru 


orice expresie care are ca operanzi şiruri: 


>>> import string 

>>> "str! ‘ing’ 4 <- Corect 

‘string’ 

>>> string.strip(’str’) + ’ing’ # <- Corect 

‘string’ 

>>> string.strip('str') ‘ing’ # <- Incorect 
File "<stdin>", line 1, in ? 

string.strip(’str’) 'ing' 


A 


SyntaxError: invalid syntax 


Sirurile de caractere sunt tratate ca vectori, la fel ca inC: primul caracter al unui şir are indicele 0. Nu există un tip 
de date separat pentru caracter. Un singur caracter este reprezentat ca un sir de lungime unu. Se pot specifica de 
asemenea subsiruri ale unui şir folosind doi indici, separați prin ” :” . Primul indice reprezintă poziţia de început 
a subşirului, iar cel de-al doilea indice, evident indicele în şirul principal la care se termină subşirul: 


>>> word[4] 
TAT 

>>> word[0:2] 
‘He’ 

>>> word[2:4] 
‘lp’ 


Daca al doilea indice nu este specificat, se considera ca subsirul se termină la sfârşitul sirului. 


Spre deosebire de C, in Python sirurile nu pot fi modificate. Atribuirea unei valori unui anumit caracter, sau unui 
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subşir dintr-un şir mai mare, va genera o eroare: 


>>> word[0] = ’x’ 

Traceback (most recent call last): 

File "<stdin>", line 1, in ? 

ypeError: object doesn’t support item assignment 
>>> word[:1] = 'Splat” 

Traceback (most recent call last): 

File "<stdin>", line 1, in ? 

ypeError: object doesn’t support slice assignment 


In orice caz, creearea unui şir nou cu un conţinut combinat este suficient de simplă şi eficientă: 


>>> 'x” + word[1:] 
'xelpA’ 

>>> 'Splat” + word[4] 
' SplataA' 


Omiterea primului sau celui de-al doilea indice în specificarea parametrilor unui subşir, are ca efect înlocuirea 
primului indice cu zero, respectiv cu lungimea şirului din care se încearcă extragerea subşirului, dacă se omite al 
doilea parametru. 


>>> word[:2] # Primele doua caractere 

Lă He’ 

>>> word[2:] # Tot sirul inafara de primele doua caractere 
r 1pA’ 


Iată incă un exemplu: 


>>> word[:2] + word[2:] 
'HelpA' 
>>> word[:3] + word[3:] 
'HelpA' 


Transmiterea unor parametrii gresiti, nu generează o eroare, pentru că în această problemă Python este foarte 
elegant. Astfel un indice care este prea mare va fi înlocuit cu dimensiunea şirului: 


>>> word[1:100] 
'elpA’ 
>>> word[10:] 


rr 


>>> word[2:1] 
rr 


Indicii pot fi şi numere negative, în acest caz se consideră că indicele zero se află cel mai la dreapta: 


>>> word[-1] + ultimul caracter 

TAT 

>>> word[-2] # penultimul caracter 

Lă Lă 

pP 

>>> word[-2:] # ultimele doua caractere 

‘pA’ 

>>> word[:-2] # totul inafara de ultimele doua caractere 
‘Hel’ 


Dar, atenţie -0 este acelaşi lucru cu 0, si nu se numara de la dreapta! 
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>>> word[-0] + (deoarece -0 egal 0) 
H’ 


Indicii negativi mai mari în valoare absolută decât dimensiunea șirului sunt trunchiaţi. Acest lucru nu funcționează 
şi la selectarea unui singur caracter ( nu a unei subsecvente ) : 


>>> word[-100:] 

'HelpA’ 

>>> word[-10] # error 

Traceback (most recent call last): 
File "<stdin>", line 1, in ? 

IndexError: string index out of range 


Mai jos aveți un tabel care vă va ajuta la înțelegerea mecanismului de numerotare al unui şir de caractere: 


+ 
| 

+ 
5 


Prima linie de numere reprezintă legătura indicilor pozitivi cu şirul. A doua linie reprezintă corespondenţa dintre 
caracterele şirului şi indicii negativi. Un subsir de la i la j este format din toate caracterele dintre cei doi indici 
i, respectiv j. Pentru indicii pozitivi lungimea subşirului este dată de diferenţa indicilor mărginaşi, dacă nici unul 
dintre ei nu este mai mare decât lungimea șirului. De exemplu lungimea subşirului word [1:3] este 2. 


Funcţia len () întoarce lungimea unui sir de caractere: 


>>> s = 'supercalifragilisticexpialidocious” 
>>> len(s) 
34 

Vedeţi şi : 


e Tipurile secvență 
(../lib/typesseg.html) 
Şirurile si şirurile Unicode descrise în sectiunea următoare sunt exemple ale tipului secvenţă şi 
suportă operaţiunile obişnuite pentru acest tip. 


e Metodele aplicabile sirurilor 
(..Aib/string-methods.html) 
Atât sirurilor simple, cât şi Unicode li se pot aplica un număr mare de metode pentru transformare şi căutare. 


e Operații de formatare a sirurilor 
(../lib/typesseg-strings.html) 
Operatiile de formatare invocate, când sirurile obişnuite sau Unicode sunt in stânga operatorului %, sunt 
descrise mai în detaliu aici. 


3.1.3 Şiruri de caractere UNICODE 


Începând cu versiunea 2.0 a limbajului Python, este pus la dispoziţia programatorului un nou tip de dată, pen- 
tru manipularea textelor: obiectul Unicode. Poate fi folosit pentru stocarea şi manipularea datelor de tip Uni- 
code(consultati http: //www.unicode.org/) şi se integrează foarte bine cu obiectele string existente, având 
un mecanism de auto-conversie. 


Unicode are avantajul că stabileşte o legătură unică între un număr şi orice caracter scris în scripturi moderne sau 
scripturi mai vechi. 
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La început au existat numai 256 de numere fiecare având asociat un caracter, şi toate textele erau asociate unei 
"pagini de cod”(code page) care făcea legătura între caractere şi numerele asociate. Acest lucru a creat foarte 
multă confuzie odată cu internationalizarea software-ului (scriere usuală : ‘i18n’ — ‘i’ + 18 characters + ‘n’). 
Unicode rezolvă aceste probleme asociând o singură pagină tuturor script-urilor. 


Crearea şirurilor de caractere Unicode este la fel de simplă ca şi crearea şirurilor obişniute : 


>>> u’Hello World !’ 
u’Hello World !’ 


Caracterul ‘u’ din fata ghilimelelor şirului indica interpretorului că trebuie să creeze un sir Unicode din expresia 
care urmează. Dacă doriţi să includeti în şir caractere speciale, o puteţi face foarte simplu folosind codarea Python 
Unicode-Escape. lată un exemplu: 


>>> u’Hello\u0020World !7 
u'Hello World !’ 


Secventa escape \u0020 indica interpretorului sa insereze caracterul cu ordinalul 0x0020 (caracterul spatiu) in- 
poziţia precizată. Alte caractere sunt utilizate folosind direct valoarea ordinalului său ca ordinal Unicode. Datorită 
faptului că primele 256 de caractere Unicode sunt aceleaşi ca şi în notația standard Latin-1, folosită în multe ţări 
occidentale, procesul de introducere a caracterelor Unicode devine mult mai simplu. 


Pentru experţi există şi un mod brut (raw-mode) identic cu cel utilizat pentru şirurile normale. Înaintea ghilimelelor 
şirului trebuie adăugat ’ur’ pentru ca Python să intre în modul Unicode direct. Conversiile \uXXXX sunt utilizate 
numai dacă este folosit un număr impar de caractere backslash(’ \’ , înaintea caracterului ’ u” : 


>>> ur’Hello\u0020World !’ 
u’ Hello World !” 

>>> ur’ Hello\\u0020World !” 
u’Hello\\\\u0020World !” 


Mod raw poate fi foarte util dacă aveţi de introdus un număr mare de backslash-uri. 


În afară de metodele de codare standard, Python oferă multe alte metode de a crea şiruri Unicode, pe baza codărilor 
cunoscute. 


Funcţia predefinită uni code () permite accesarea tuturor CODEC-urilor Unicode (CODEC = COder & DE- 
Coder). Câteva dintre codificările foarte cunoscute ale caror CODEC-uri au fost convertite sunt : Latin-1, ASCII, 
UTF-8 şi UTF-16. Ultimele două permit stocarea caracterelor Unicode pe unul sau mai multi octeți. Codificarea 
implicită este ASCII, care permite treacerea caracterelor cuprinse între O şi 127, dar blocheză celelalte caractere 
semnalizând eroare. Când un şir Unicode este tipărit, scris într-un fişier, sau convertit cu funcţia str (), conversia 
porneşte utilizând codarea implicită. 


>>> u"abc" 
u’ abc’ 
>>> str(u"abc") 
‘abc’ 
>>> u"äöü" 
u’ \xe4\xf6\xfc’ 
>>> str (u"adti") 
Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
UnicodeError: ASCII encoding error: ordinal not in range(128) 


Pentru a converti un şir Unicode într-un sir pe 8 biti utilizând o anumită codificare, obiectele Unicode furnizează 
metoda encode () , care are un singur argument, numele codului. Este de preferat ca numele codurilor sá se scrie 
cu litere mici. 
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>>> u"äöü".encode ('utf-8') 
"\xc3\xa4\xc3\xb6\xc3\xbe’ 


Dacă aveţi datele intr-o anume codificare şi doriţi să obţineţi un şir Unicode corespondent din ele, folosiţi funcţia 
unicode () cu numele codului ca al doilea argument. 


>>> unicode (7 \xc3\xa4\xc3\xb6\xc3\xbce’, 'utf-87) 
u’ \xe4\xf6\xfc’ 


3.1.4 Liste 


Python pune la dispozitia programatorului o serie de date structurate, folosite pentru a grupa, a aduna la un loc 
mai multe valori. Cea mai flexibilă astfel de structură este lista. O lista poate fi scrisă ca o serie de valori separate 
prin virgulă, şi aflată între paranteze pătrate. Elementele unei liste nu trebuie să fie neapărat de acelaşi tip: 


>>> a = ['spam', 'eggs', 100, 1234] 
>>> a 


[ spam", 'eggs', 100, 1234] 


La fel ca şi la şiruri, primul element al unei liste are indicele 0. În acelaşi fel ca şi la şiruri, listele pot fi poziţionate, 
concatenate şi aşa mai departe: 


>>> a[0] 
‘spam’ 
>>> a[3] 
1234 
>>> a[-2] 
100 
>>> a[1:-1] 

“eggs”, 100] 

>>> a[:2] + [’bacon’, 2x2] 

‘spam’, 'eggs', ‘bacon’, 4] 

>>> 3xa[:3] + [’Boe!’] 

‘spam’, 'eggs', 100, 'spam', 'eggs', 100, 'spam”, 'eggs”, 100, 'Boe!'] 


Spre deosebire se siruri, elementele unei liste pot fi modificate: 


>>> a 

[’spam’, 'eggs”, 100, 1234] 
>>> a[2] = a[2] + 23 

>>> a 


[’spam’, 'eggs', 123, 1234] 


Funcţia len () se aplică şi listelor : 


>>> len(a) 
4 


Utilizarea sublistelor este de asemenea posibilă. Prin folosirea lor se poate modifica chiar şi dimensiunea listei : 
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>>> # substituirea unor componente 
a[0:2] = [1,12] 

>>> a 

[1,12,123,1234] 

>>> $ eliminarea unor componente 
a[0:2] = [] 

>>> a 

[123,1234] 

>>> # inserarea unor componente 
a[1:1] = [’bletch’,’xyzzy’] 

>>> a 

[123,’bletch’,’xyzzy’,1234] 

>>> # inserarea unei liste la debutul ei 
a[:0] =a 

>>> a 

[123,’bletch’,’xyzzy’,1234,123,’bletch’,’xyzzy’,1234] 

>>> len(a) 

8 


Este posibil să creaţi liste din alte liste (de exemplu prin concatenare): 


>>> q = [2, 3] 
>>> p = [1, q, 4] 
>>> len (p) 


>>> p[1] 
[2, 3] 
>>> p[1] [0] 


>>> p[1].append('xtra') # Vezi sectiunea 5.1 
>>> p 

[1, [27 3, ‘xtra’], 4] 

>>> q 

[2, 3, *xtra'] 


Observati că în ultimul exemplu , p [1] şi q fac referire la acelaşi obiect. Vom reveni cu detalii despre semantica 
obiectelor mai târziu. 


3.2 Primii paşi în programare 


Bineînţeles că putem folosi Python şi la alte lucruri decât pentru a aduna 2 cu 2. Putem de exmplu să generăm o 
subsecventa din şirul lui Fibonacci: 
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>>> # Seria lui Fibonacci: 
# Suma a doua elemente reprezinta urmatorul element. 
a, b = 0, 1 
>>> while b < 10: 
print b 
a, b = b, atb 


O WU W DN ne 


Acest exemplu demonstrează următoarele noţiuni: 


e Prima linie conţine o atribuire multiplă. Varibilele a şi b iau valorile 0 respectiv 1. Pe ultima linie, de 
asemenea este folosită atribuirea multiplă. Evaluarea expresiilor din partea dreaptă a unei atribuiri se face 
înainte de orice atribuire. Evaluarea se face de la stânga la dreapta. 


e Bucla while se execută atâta timp cat b < 10 (atâta timp cât condiţia este adevărată). La fel ca în C, 
zero înseamnă fals, şi orice număr diferit de zero înseamnă adevărat. Condiţia poate fi un şir, un element 
de listă, absolut orice. Orice secvenţă de lungime diferită de zero înseamnă adevărat, şi invers. Condiţia 
folosită în acest exemplu este o comparaţie. Comparatorii standard sunt la fel ca în C: <(mai mic), >(mai 
mare), ==(egal), <=(mai mic sau egal), >=(mai mare sau egal), ! =(diferit). 


e Instrucţiunile din buclă sunt aliniate. Alinierea (indentation) reprezintă modul în care Python grupează 
instrucțiunile. Deocamdată (!) Python nu dispune de un editor în linie de comandă inteligent, astfel încât 
alinierea, tabularea să se facă automat. Sunteţi deci obligat să folosiţi tab sau spaţii pentru a realiza gruparea 
instrucţiunilor. Când veţi scrie programe Python veţi folosi un editor de text. Majoritatea editoarelor de la 
ora actuală realizează automat tabularea. Pentru a încheia un bloc de instuctiuni trebuie introdusă o linie 
goală pentru a indica editorului că editarea blocului de comenzi s-a încheiat (editorul nu poate ghici când 
aţi introdus ultima linie. Atenţie ! fiecare instrucţiune dintr-un bloc de instrucţiuni trebuie să aibă aceleaşi 
număr de spaţii şi taburi înainte, deci instrucţiunile trebuie să fie perfect aliniate. 


e Instrucţiunea print afişează expresia pe care o primeşte ca parametru. Şirurile de caractere sunt afişate 
fără ghilimele şi cu un spaţiu este inserat între elemente, astfel încât afişarea diverselor valori să meargă de 
la sine: 


>>> 1 = 256x256 
>>> print 'Valoarea lui i este:’, i 
Valoarea lui i este: 65536 


O virgulă la sfârşitul listei de parametrii ai instrucţiunii print, inhibă saltul cursorului pe linia următoare 
la sfârşitul instrucţiunii: 
>>> a, b= 0, 1 
>>> while b < 1000: 
print b, 
a, b = py atb 


1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 


Observati că interpretorul sare la linia următoare înainte de a începe afişarea, dacă ultima linie a fost incom- 
pletă. 
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CAPITOLUL 
PATRU 


Structuri de control 


În afară de buclele de tip while (explicate anterior), Python dispune de structurile de control obişnuite, întâlnite 
şi în celelalte limbaje. 


4.1 Instrucţiunea if 


Poate că cea mai cunoscută instrucţiune de control este instrucţiunea if. Exemplu: 


>>> x = int (raw_input ("Introduceti un numar intreg : ")) 
>>> if x < 0: 
x = 0 
print 'Negativul schimbat in zero’ 
elif x == 0: 
print ‘Zero’ 
elif x == 1: 
print 'Unul singur’ 
else: 
print ‘Mai multi’ 


Pot exista mai multe secţiuni elif sau niciuna, iar secţiunea else este opţională. Cuvântul cheie ‘elif’ 
este evident prescurtarea de la ‘elseif’, şi este folositor pentru a evita tabularea excesivă. O secvenţă 
if..elif..elif funcţionează ca un bloc case sau switch, secvenţe proprii altor limbaje . 


4.2 Instrucţiunea for 


Instrucţiunea for din Python diferă un pic faţă de ce a-ţi întâlnit în C sau Pascal. În loc de o iteratie dată 
de o progresie aritmetică (Pascal), sau de o iteratie foarte flexibilă, pentru care programatorul poate defini atât 
pasul iteratiei, cât şi condiţia de oprire (C), iteratiile instrucţiunii Python for funcţionează după elementele unei 
secvenţe (sir sau listă). 


>>> $ Masoara marimea unor siruri 
a = [’cat’, “window”, 'defenestrate'] 
>>> for x in a: 
print x, len(x) 
cat 3 
window 6 
defenestrate 12 


Nu este normal (si sigur) ca secvenţa iterată să fie modificată în timpul secventei for ( este cazul numai al 
secventelor modificabile, cum ar fi listele). Dacă apare necesitatea de a modifica secvenţa in timpul iteratiei, 
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iteratia trebuie să fie asociată unei copii a secventei. Notatia subsecventelor realizează o particularitate convenabilă 


>>> for x in a[:]: + copiaza intreaga lista 
if len(x) > 6: a.insert (0, x) 


>>> a 
[’defenestrate’, 'cat', “window”, ’defenetrate’ ] 


4.3 Funcţia range () 


Daca este necesară o iteratie pe o mulţime de numere, puteţi folosi funcţia range () pentru a genera liste ce 
conţin progresii aritmetice : 


>>> range (10) 
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] 


Paramentrul furnizat funcţiei range () nu va fi niciodată un membru al secventei. Este posibil ca funcţia 
range () să genereze o secvenţă începând cu un alt număr decât 0, sau ratia progresiei aritmetice poate fi modi- 
ficată: 


>>> range (5, 10) 

[Sy 465. “Ry 8y 9] 

>>> range(0, 10, 3) 

[0, 3, 6, 9] 

>>> range(-10, 100, 30) 
[-10, -40, -70] 


Pentru a realiza o iteratie pe o mulţime de numere folosiţi funcţiile range () si len () astfel: 


>>> a = ["Mary', ‘had’, 'a', ‘little’, 'lamb”] 
>>> for i in range(len(a)): 
print i, ali] 


Mary 
had 

a 
little 
lamb 


PUN Os 


4.4 Instrucţiunile break şi continue, şi clauze else pentru bucle 


La fel ca în C, instrucţiunea break termină forţat orice buclă while sau for. Instrucţiunea continue trece 
necondiţionat la următoarea iteratie. Instrucţiunile iterative pot avea şi o clauză else. Instrucţiunile din cadrul 
unei astfel de clauze e1 se sunt executate atunci când bucla se termină odată cu terminarea listei (for) sau atunci 
când condiţia buclei devine falsă (pentru while) aceste instrucţiuni nu sunt executate dacă bucla este terminată 
printr-o instrucţiune break. Iată un exemplu care determină numerele prime până la 10: 
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>>> for n in range(2, 10): 
for x in range (2, n): 
if n $ x == 
print n, 'egal cu’, x, 'x*’, n/x 
break 
else: 
+ bucla s-a epuizat fara sa gaseasca un factor 


print n,’este un numar prim’ 


este un numar prim 
este un numar prim 
egal cu 2 * 2 
este un numar prim 
egal cu 2 x 3 
este un numar prim 
egal cu 2 x 4 
egal cu 3 > 3 


00 ANU BWDN 


4.5 Instrucţiunea pass 


Instrucţiunea pass nu execută nimic. Poate fi folosită atunci când este necesară prezenţa sintactică a unei in- 
structiuni, fără ca aceasta să execute ceva: 


>>> while 1: 
pass # Asteapta pentru intrerupere de la tastatura 


4.6 Definirea funcţiilor 
Putem crea o funcţie care generează şirul lui Fibonacci până la o limită arbitrară: 


>>> def fib(n): # Scrie sirul lui Fibonacci pana lan 
"Scrie sirul lui Fibonacci pana la n" 
a, b= 0, 1 
while b < n: 
print b, 
a, b = b, atb 


>>> # Folosim functia creata 
fib (2000) 
1 1 2 3 58 13 21 34 55 89 144 233 377 610 987 1597 


Cuvântul cheie def este primul din definiția unei funcții. Acesteia trebuie să îi urmeze numele funcției şi, în 
paranteză, o listă de parametrii. Instrucţiunile care formează funcția încep pe linia imediat următoare şi trebuie 
să fie distantate mai mult decât antetul funcției fata de margine. Prima instrucțiune din corpul funcției poate fi, 
opțional, un şir de caractere. Acest şir reprezentând documentaţia funcției (docstring = şirul de documentaţie al 
funcţiei). Există utilitare care generează documentaţie pornind de la aceste şiruri, deci este o practică bună să vă 
folosiţi de această facilitate. 


Execuţia unei funcţii crează o nouă tabelă de simboluri, folosită pentru variabilele locale. Altfel spus toate atribuir- 
ile din cadrul unei funcţii vor stoca valorile în tabela de simboluri locală. Atunci când interpretorul găseşte un 
nume de variabilă, întâi caută în tabela de simboluri locală, apoi în cea globală şi apoi în cea predefinită. 


Cu toate acestea variabilelor globale nu li se pot atribui valori în cadrul unei funcţii, decât daca se foloseşte 
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instrucţiunea global. 


Parametrii actuali ai unei funcţii apelate sunt introduşi în tabela de simboluri locală a acelei funcţii în momentul 
apelării ei. Astfel transferul argumentelor se face utilizând apelul prin valoare (unde valoare este totdeauna un 
obiect referinţă, nu valoarea obiectului).! 


Când o funcţie apelează o alta funcţie, este creată o nouă tabelă de simboluri pentru funcţia apelată. 
Definirea unei funcţii trece numele funcţiei în tabela de simboluri curentă. 


Funcţia nou creată este recunoscută de interpretor ca o funcţie definită de utilizator. In Python există un mecanism 
de redenumire a funcţiilor: 


>>> fib 

<function object at 10042ed0> 
>>> f = fib 

>>> £(100) 

1,1 2 3 5 813 21 3455 89 


Ati putea obiecta că funcţia fib este o procedură nu o funcţie. În Python, la fel ca în C, procedurile sunt 
funcţii, numai că nu returnează nici o valoare. Tehnic vorbind, procedurile returnează totuşi o valoare, aceasta 
este None(niciuna). None este un cuvânt cheie (predefinit). În mod normal valoarea None nu este afişată de 
interpretor. Totuşi dacă doriţi să vă convingeti că aşa funcţionează procedurile încercaţi următorul exemplu: 


>>> print fib(0) 
None 


Este foarte simplu să construim o funcţie care întoarce ca rezultat şirul lui Fibonacci: 


>>> def fib2 (n): + Intoarce sirul lui Fibonacci pana lan 
"Intoarce o lista continand sirul lui Fibonacci pana la n" 
result = [] 
a, b= 0, 1 
while b< n: 
result.append(b) # vezi mai jos 
a, b = b, atb 
return result 


>>> £100 = fib2(100) + apelarea functiei 
>>> £100 # afisarea rezultatului 
li, dp 2, 3, By 8, 13, 21, 34, 55, 89] 


Acest exemplu demonstreazá mai multe facilitáti ale limbajului Python: 


e Instrucţiunea return întoarce rezultatul funcţiei. return fără nici un parametru întoarce ca rezultat al 
funcţiei valoarea None. Puteţi folosi return fără parametrii pentru a încheia execuţia unei funcţii înainte 
de a se ajunge la finalul instrucţiunilor din cadrul funcţiei. Valoarea None este de asemenea întoarsă ca 
rezultat al unei funcţii atunci când au fost executate toate instrucţiunile procedurii. 


e Instrucţiunea result .append (b) apelează o metodă a obiectului result. O metodă este o funcţie 
care “aparţine” unui obiect. Metodele sunt apelate folosind sintaxa obj .met odă(unde obj este un obiect, 
poate fi si o expresie, iar metodă este numele metodei ce este apelată). În funcție de tipul lor, obiectele 
pot avea diferite metode. Este posibil să existe metode de tipuri diferite fără a se crea confuzii. Este de 
asemenea posibil să creaţi obiecte şi metode folosind clasele, dar despre clase vom discuta mai târziu. 
Metoda append este definită pentru obiecte de tip listă, şi adaugă un element la sfârşitul listei. In acest 
exemplu ar fi echivalentă cu ‘result = result + [b]’ dar mult mai eficientă. 


l De fapt apelul prin referință poate fi mai bine înţeles daca este transmis un obiect modificabil si apelantul va vedea dacă în urma apelarii 
obiectul s-a modificat ( ex.: un element inserat într-o listă). 
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4.7 Mai multe despre definirea funcţiilor 


Este posibil în Python să definim funcţii cu un număr variabil de argumente. Există trei modalitati de a realiza 
acest lucru, care pot fi combinate. 


4.7.1 Valori implicite pentru argumente 


Cea mai utilă metodă este să specificaţi valori implicite pentru argumente. În acest fel creaţi o funcţie care poate 
fi apelată cu mai puţine argumente decât a fost definită: 


def ask_ok (prompt, retries=4, complaint=’Da sau nu va rog!’): 
while 1: 

ok = raw_input (prompt) 
if ok in {’d’, 'da'): return 1 
if ok in {’n’, ‘nu’): return 0 
retries = retries 1 
if retries < 0: raise IOError, 'refusenik user’ 
print complaint 


Funcţia definită mai sus poate fi apelată in două moduri: 


ask_ok (* Sunteţi sigur că doriţi să ieşiţi ?’) sau: ask_ok(’Doriti să ştergeţi 
fişierul ?’, 2) 


Valorile implicite sunt evaluate în timpul interpretării definiţiei funcţiei, deci următoarea secvenţă 


def f(arg=i): 
print arg 


va afişa 5. 


ATENTIE!!!: Valorile implicite sunt evaluate o singură dată. Aveţi grijă atunci când valoarea implicită este 
un obiect modificabil, cum este lista, dicţionarul, sau instantierea unei clase. De exemplu funcţia următoare 
acumulează într-o listă argumentele ce îi sunt transmise în timpul unor apeluri consecutive: 


def f(a, L=[]): 
L.append (a) 
return A 


print f(1) 
print f(2) 
print f(3) 


va afişa 


[1] 
[1, 2] 
[1, 2, 3] 


Dacă nu doriţi ca valoarea implicită să fie reţinută după terminarea funcţiei, puteţi proceda ca în exemplul următor: 


4.7. Mai multe despre definirea funcţiilor 23 


def f(a, L=None): 
if L is None: 
L= [] 
L. append (a) 
return L 


4.7.2 Argumente de tip cuvinte cheie 


Functiile pot fi apelate folosind in loc de argumente cuvinte cheie de forma: cuvant_cheie = valoare. 
Pentru exemplificare observati functia: 


def parrot (voltage, state=’mort’, action=’ zboara’, type=’Norvegian Blue’): 


print "-- Acest papagal nu", action 

print "daca pui”, voltage, "volti prin el." 
print "-- Doamne !", type 

print "-- E ", state, "!" 


care poate fi apelată în mai multe moduri: 


parrot (1000) 

parrot (action=’ BOOM’, voltage=10000) 
parrot(’o mie’, state=’apasa iarba!) 
parrot (“un milion’, “fara viata’, 'sare!') 


Dar următoarele apeluri ar genera erori: 


parrot() # Lipseste argumentul obligatoriu voltage 

parrot (voltage=5.0, 'mort”) + Dupa cuvantul cheie trebuie sa urmeze 
un argument tip cheie 

parrot (110, voltage=220) # Doua valori atribuite aceleiasi varibile 
parrot (actor='John Cleese’) + Cuvant cheie necunoscut 


În general o listă de argumente trebuie să aibe oricâte argumente pozitionale, urmate de oricâte argumente de 
tip cuvinte cheie, unde cuvintele cheie trebuie alese din lista parametrilor formali. Nu este important dacă un 
parametru formal are o valoare implicită sau nu. Nici un argument nu poate primi o valoare de mai multe ori - 
numele de parametrii formali corespunzătoare argumentelor pozitionale nu pot fi folosite drept cuvinte cheie în 
cadrul aceluiaşi apel. lată un exemplu cu erori datorate acestei reguli: 


>>> def function(a): 
pass 


>>> function (0, a=0) 

Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
ypeError: keyword parameter redefined 


Atunci când unul dintre parametrii este de forma x *nume, funcţia va primi o lista care va conţine parametrii de 
tip cuvânt cheie. Dacă se foloseşte un parametru de tipul xnume, funcţia va primi o listă conţinând argumentele 
suplimentare în afara celor formale. Dacă sunt folosiţi împreună parametrul nume trebuie să se afle înaintea celui 
de tip x xnume. Totul poate părea ambiguu dar veţi fi lămuriţi imediat: 
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def cheeseshop (kind, *arguments, **xkeywords) : 
print " = Aveti", kind, "?" 
print " - Nu, nu avem", kind 
for arg in arguments: print arg 
print '-'x40 
for kw in keywords.keys(): print kw, ’:’, keywords[kw] 


Un apel al acestei funcţii ar arăta astfel: 


cheeseshop (* Limburger', "Se vinde foarte repede, d-le", 
"Se vinde foarte, FOARTE repede, d-le", 
client=’ John Cleese’, 
manager=’Michael Palin’, 
sketch=’Cheese Shop Sketch’ ) 


lar rezultatul va fi următorul: 


- Aveti Limburger? 

- Nu, nu avem Limburger 

Se vinde foarte repede, d-l 

Se vinde foarte, FOARTE repede, d-le. 


client : John Cleese 
manager : Michael Palin 
sketch : Cheese Shop Sketch 


4.7.3 Liste de argumente arbitrare 


O funcţie poate fi apelată cu un număr arbitrar de argumente. Înainte de argumentele arbitrare (opţionale) pot 
exista mai multe argumente normale: 


def fprintf(file, format, xargs): 
file.write(format % args) 


4.7.4 Dspachetarea listelor de argumente 


Situţia inversă este aceea in care argumentele se găsesc deja într-o listă sau pereche, dar este necesară despa- 
chetarea lor pentru apelarea unei funcţii care necesită argumente separate pozitional. De exemplu, functia interna 
range () necesita parametrii separați pentru start şi stop. Dacă argumentele nu sunt transmise separat, 
scrieţi apelarea funcţiei folosind operatorul x pentru despachetarea argumentelor dintr-o listă sau dintr-o pereche : 


>>> range (3, 6) + apelare normala 

[37 4, 5] 

>>> args = [3, 6] 

>>> range (xargs) + apelare cu despachetarea argumentelor dintr-o lista 
[Sr 4; 5] 


4.7.5 Forme Lambda 


La cererea utilizatorilor de Python, au fost adăugate câteva facilităţi specifice limbajelor funcţionale şi Lisp-ului. 


Folosind cuvântul cheie lambda puteţi crea mici funcţii. Iată o funcţie care întoarce ca rezultat suma argu- 
mentelor: ‘lambda a, b : a+b’. Formele lambda pot fi folosite acolo unde sunt necesare funcţii obiect. 
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Aceste funcţii sunt restrânse sintactic la o singură expresie: 


>>> def make_incrementor (n): 
return lambda x, incr=n: x+incr 


>>> f = make_incrementor (42) 
>>> £(0) 

42 

>>> £(1) 

43 

>>> 


4.7.6 Sirurile de documentaţie 


Există anumite convenţii privind conţinutul şi formatarea şirurilor de documentaţie. 


Prima linie ar trebui să fie scurtă şi foarte concisă. Pentru concizie nu ar trebui precizat numele obiectivului sau 
tipul, acestea fiind subintelese. Această linie trebuie să înceapă cu literă mare şi să se termine cu virgulă. 


Dacă există mai multe linii, cea de-a doua ar trebui să fie vidă, pentru a separa descrierea scurtă de cea amănunţită. 
Următoarele linii ar trebui să descrie mai pe larg obiectul, semnificaţia parametrilor, etc. 


Interpretorul Python ia în consideraţie spaţiile din şirurile de caractere împărţite pe mai multe linii, din această 
cauză pentru a avea o documentaţie aranjată ”frumos” trebuie să vă folosiţi de un mic ”truc” la fel ca în exemplul 
următor: 


>>> def my_function(): 
" " "Nu face decat documentarea. 


Chiar nu face nimic! 
pass 


>>> print my_function.__doc 
Nu face decat documentarea. 


Chiar nu face nimic! 
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CAPITOLUL 
CINCI 


Structuri de date 


Acest capitol subliniază anumite lucruri deja cunoscute şi descrie altele noi. 


5.1 Mai multe despre liste 


Tipul de date listă mai dispune de câteva metode. Iată toate metodele obiectelor de tip listă: 


append (x) Adaugă un element la sfârşitul listei. 
extend(L) Adaugă la sfârşitul listei, elementele listei furnizate ca parametru. 


insert (i, x) Inserează un element într-o anumită poziţie. Primul argument reprezintă indicele elementului 
din listă înaintea căruia se va face insertia, deci a.insert (0,x) va insera elementul °x’ la începutul 
listei, iar a. insert (len (a) ,x) este echivalent cu a. append (x). 


remove (x) Şterge din listă primul element găsit cu valoarea ’x’. Dacă nu există un astfel de element apare o 
eroare. 


pop ( [i J Şterge din listă elementul de pe poziția *1”, şi întoarce valoarea acestuia. Dacă nu este specificat nici 
un parametru a . pop (), va şterge şi va returna ultimul element din lista. 


index (x) Întoarce indicele primului parametru din listă care are valoarea °x’. 
count (x) Întoarce numărul de apariţii ale valorii °x’ între elementele listei. 
sort () Sortează elementele listei. 


reverse () Schimbă ordinea elementelor din listă. 


Iată un exemplu care foloseşte majoritatea metodelor: 
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>>> a = [66.6, 333, 333, 1, 1234.5] 
>>> print a.count (333), a.count (66.6), a.count(’x’) 


210 
>>> a.insert(2, -1) 
>>> a.append (333) 
>>> a 
66.6, 333, -1, 333, 1, 1234.5, 333] 
>>> a.index (333) 


>>> a.remove (333) 

>>> a 

66.6, 1, 333; 1, 1234.5, -333 
>>> a.reverse () 

>>> a 

333, 1234.5, 1; 333, -1y 66:6 
>>> a.sort () 

>>> a 

= Ap 66.26, 3337 333 123435 


5.1.1 Folosirea listelor drept stive 


Obiectele de tip listă pot fi folosite foarte uşor pentru a simula comportamentul unei stive. Pentru a adăuga un 
element pe stivă (PUSH), puteţi folosi append (). Pentru a scoate un element din stivă (POP), folosiţi pop () 
fără a specifica un index. lată un exemplu: 


>>> stack = [3, 4, 5] 
>>> stack.append (6) 
>>> stack.append (7) 
>>> stack 

[3, 4, 5, 6, 7] 

>>> stack.pop() 

7 


>>> stack 
[3, 4, 5, 6] 
>>> stack.pop () 


>>> stack.pop () 


5.1.2 Folosirea listelor drept cozi 


Puteţi folosi listele foarte convenabil, pentru a implementa cozi. Spre deosebire de stive unde primul element 
adăugat este ultimul scos, la cozi primul element adăugat este primul scos. Pentru a adăuga un element folosiţi 
append (), iar pentru a extrage un element folosiţi pop (0): 
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>>> queue = ["Eric", "Ion", "Mihai"] 
>>> queue.append ("Razvan") 

>>> queue.append ("Cristi") 

>>> queue.pop (0) 

"Eric! 

>>> queue.pop (0) 

‘Ton’ 

>>> queue 

['Mihai', 'Razvan', '’Cristi’ ] 


5.1.3 Instrumente de programare funcţională 


Există trei funcţii predefinite care sunt foarte utile în lucrul cu liste: filter (), map(), reduce). 


Funcţia filter (), cu sintaxa filter (funcţie, secvență), întoarce o secvenţă formată din elementele 
secventei specificate ca parametru, care îndeplineşte condiţia testată de funcție. Exemplul care urmează calculează 
numerele prime din intervalul 2, 25: 


>>> def f(x): return x % 2 != 0 and x $ 3 != 0 


>>> filter(f, range(2, 25)) 
[Dye he Lb Ape LP, 197-23) 


Funcţia map (), cu sintaxa map (funcție, secvenţă), apelează funcţia specificată ca parametru pentru 
fiecare element din secvenţă, şi întoarce o nouă listă formată din rezultatele întoarse de funcţie. Pentru a calcula 
pătratele unor numere dintr-o listă puteţi folosi o secvenţă similară celei ce urmează: 


>>> def cube(x): return xxxxx 


>>> map(cube, range(1, 11)) 
[L, 8; 27, 64; 125, 216, 343, 512, 729, 1000] 


Functia map () poate accepta ca parametrii mai multe secvente. Ín acest caz functia transmisá ca parametru trebuie 
să fie modificată corespunzător, astfel încât să accepte acelaşi număr de parametrii câte secvenţe sunt transmise. 
Dacă secvențele sunt diferite ca lungime, atunci când una dintre secvenţe s-a terminat, în loc de un element funcţiei 
i se transmite None. Dacă în loc de un nume de funcţie, se transmite funcţiei map () None, atunci funcţia va fi 
înlocuită cu o funcţie care va întoarce ca rezultat parametrii primiţi. Puteţi folosi comportamentul funcţiei map () 
pentru a genera perchi de numere provenind din două liste: 


>>> seq = range (8) 
>>> def square (x): return xxx 


>>> map (None, seq, map (square, seqg)) 
[(0, 0), (1, 1), (2, 4), (3, 9), (4, 16), (5, 25), (6, 36), (7, 49)] 


Funcţia reduce (funcţie, secvenţă) întoarce o valoare simplă care este calculată în felul următor: este 
apelată funcţia (obligatoriu o funcţie binară care acceptă numai 2 parametrii), cu parametrii primul şi al doilea 
termen al secventei. Funcţia întoarce un rezultat care împreună cu al treilea element sunt transmise din nou 
funcţiei, care generează un alt rezultat şi aşa mai departe, până ce lista este epuizată. 


Exemplul de mai jos calculează suma primelor numere naturale: 
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>>> def add(x,y): return x+y 


>>> reduce (add, range (1, 11)) 
55 


Dacă există un singur element în secventáva fi returnată valoarea acestuia. Dacă lista este goală, va fi generată 
o excepţie. Funcţia reduce () poate primi şi un al treilea parametru care semnifică valoarea de la care începe 
calculul. În acest caz primul apel al funcţiei are ca parametrii această valoare şi primul element al listei. Dacă 
funcţia reduce () este apelată cu trei parametrii, iar lista este goală, aceasta va întoarce ca rezultat al treilea 
parametru. lată un exemplu care ilustrează modul de lucru al funcţiei reduce (): 


>>> def sum(seq): 
def add(x,y): return x+y 
return reduce(add, seq, 0) 


>>> sum(range (1, 11)) 
55 

>>> sum([]) 

0 


5.1.4 Un alt mod de a genera liste 


Există un mod de a crea liste mult mai concis decât prin intermediul funcţiilor map (), filter() sau 
lambda (). Definiţia listei este, de cele mai multe ori, mult mai clară decât cea obţinută prin alte metode. Acest 
mod generalizat, de a genera, a defini liste constă în asocierea unei expresii, cu o clauză for şi cu niciuna sau 
mai multe clauze for sau if. Rezultatul va fi o listă care provine din evaluarea expresiei în contextul clauzelor 


for şi if ce urmează. Dacă rezultatul evaluării expresiei va fi o pereche, atunci expresia trebuie parantezata 
corespunzător: 


>>> freshfruit = [’ banana’, ’ loganberry ’, ‘passion fruit '] 
>>> [weapon.strip() for weapon in freshfruit] 
[’banana’, 'loganberry', "passion fruit’ ] 


>>> vec = [2, 4, 6] 

>>> [3*x for x in vec] 

[6, 12, 18] 

>>> [3xx for x in vec if x > 3] 
(12; 181] 


>>> [3xx for x in vec if x < 2] 


[] 


>>> [{x: xxx2) for x in vec] 
[{2: 4}, {4: 16}, {6: 36}] 


>>> [[x,x**2] for x in vec] 
[[2, 4], [4, 16], [6, 36]] 
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>>> [x, x**2 for x in vec] # error parens required for tuples 
File "<stdin>", line 1, in ? 
[x, x**2 for x in vec] 


A 


SyntaxError: invalid syntax 


>>> [(x, x**2) for x in vec] 
[(2, 4), (4, 16), (6, 36)] 


>>> vecl = [2, 4, 6] 
>>> [xx*y for x in vecl for y in vec2] 
[8, 6, -18, 16, 12, -36, 24, 18, -54] 


>>> [x+y for x in vecl for y in vec2] 
[6, Ir =y 8, ay =5, 10, 9, =3] 


5.2 Instrucţiunea del 


Există o metodă de a şterge un element dintr-o listă specificând indicele elementului în loc de valoarea elementului. 
Această metodă poate fi folosită şi pentru a şterge porţiuni dintr-o listă. Toate acestea pot fi realizate utilizând 
instrucţiunea del: 


>>> a 

=i; ly 66.6, 333, 333, 1234.5] 
>>> del a[0] 

>>> a 

1, 66.6, 333, 333, 1234.5] 

>>> del a[2:4] 

>>> a 

1, 66.6, 1234.5] 


Instrucţiunea del poate fi folosită şi pentru a şterge variabile, de exemplu o întreagă lista: 


>>> del a 


Vom vedea mai târziu şi alte modalităţi de a utiliza instrucţiunea del. 


5.3 Perechi şi secvenţe 


' Am obsevat până acum că listele şi şirurile de caractere au multe caracteristici comune, de exemplu: indexarea 
şi poziţionarea (slicing). Şirurile şi listele sunt două exemple de tipuri de date secvenţă. Deoarece Python este un 
limbaj care evoluează, în timp pot fi adăugate şi alte tipuri de date secvenţă. Există şi un alt tip standard de date: 
perechea (enumerarea). 


O pereche, o enumerare, este formată din mai multe valori separate prin virgule: 


| N.T. termenul românesc PERECHE este impropriu, forma originală fiind TUPLE. 
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>>> t = 12345, 54321, ‘hello!’ 

>>> t[0] 

12345 

>>> t 

(12345, 54321, 'hello!') 

>>> $ enumerarile pot fi imbricate, combinate 
OS Er ml 2y 3 AO) 

>>> u 

((12345, 54321, ‘hello!’), (1, 2, 3, 4 ,5)) 


După cum puteţi vedea perechile(enumerările) sunt afişate între paranteze astfel încât enumerările sau perechile 
îmbricate să fie interpretate corect. Perechile pot fi introduse cu sau fără paranteze, însă, adesea, parantezele sunt 
necesare. 


Perechile au multe utilizări. De exemplu : perechi de coordonate (x,y), înregistrările angajaţilor dintr-o bază de 
date, etc. Puteţi face o analogie (atâta timp cât rămâne numai o analogie menită să vă ajute la înţelegerea acestui tip 
de date) între tipurile de date compuse ce pot fi definite cu struct din C++, şi perechile din Python. Perechile, 
la fel ca şirurile nu pot fi modificate: nu pot fi atribuite valori unui anumit element al unei perechi (puteţi însă să 
simulati o modificare folosind alte metode). Este posibil să creaţi perechi care contin obiecte modificabile, cum 
sunt listele de exemplu. 


O problemă deosebită o constituie crearea perechilor cu zero sau un element. Există însă câteva "trucuri” de 
sintaxă care pot fi folosite pentru a rezolva această problemă. Perechile vide pot fi construite folosind o pereche 
de paranteze fără nimic între ele. O pereche cu un singur element poate fi construită specificând valoarea care va 
fi conținută în pereche urmată de o virgulă. Cam neplăcut, dar funcţionează: 


>>> empty = 0 


>>> singleton = ‘hello’, $ <---- observati virgula 
>>> len(empty) 

0 

>>> len(singleton) 

1 

(‘hello’,) 


Instrucţiunea t = 12345, 54321, '’Salut !” este un exemplu de impachetare. Valorile 12345, 54321 si 
"Salut !’ sunt “împachetate” împreună. Operația inversă este de asemenea posibilă: 


>>> X, Yy, Z= t 


Această operaţie este numită suficient de elocvent ”despachtarea unei secvenţe”. Despachetarea unei secvenţe 
necesită ca lista de variabile de la stânga atribuirii să conţină tot atâtea variabile cât secvenţa împachetată de la 
dreapta. De observat este faptul că îmbricarea nu este decât o combinaţie succesivă de împachetări sau despa- 
chetări! Ingenios, nu?! 


Există o asimetrie aici: în timp ce o împachetare va genera întotdeauna o pereche, despachtarea funcţionează 
pentru orice fel de secvenţă. 


5.4 Seturi 


Limbajul Python are şi un tip de date pentru seturi. Un set este o colecţie neordonatá de elemente unice (fara 
duplicate). Esenţa ei constă în testarea membrilor şi eliminarea duplicatelor. Obiectele de tip set suportă, de 
asemenea, operaţii matematice ca : uniunea, intersecţia, diferenţa şi diferenţa simetrică. 


Iată o scurtă demonstraţie : 
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>>> basket = [’apple’, 'orange', 'apple', 'pear”, 'orange', ‘banana’ ] 

>>> fruits = set (basket) + creaza un set fara duplicate 
>>> fruits 

set (['orange', ‘pear’, 'apple', ‘banana’ ]) 

>>> 'orange” in fruits + testarea rapida a membrilor 
True 

>>> ‘crabgrass’ in fruits 

False 

>>> # Dmonstrarea operatiilor set pentru literele unice a doua cuvinte 


Vv 

Ve 

Ve 

w 
| 


= set (’abracadabra’ ) 
>>> b = set (’alacazam’ ) 
>>> a # literele unice dina 
Setiltal yy nj “be, “et. al) 
>>> a-b # literele unice din b 
set([’r’, ‘da’ 21) 
>>> a | b # literele din a sau b 
sét (Irar g “cd, Tr; (al, The, tm, EZ CL" 4) 
>>> a&b + literele atat din a cat si din b 
set (['a', 'c']) 
>>> ci ei + literele din a sau b , dar nu din amandoua 
set (PrE y Ed”, "bo"; Pmt, rze 1171) 


5.5 Dicţionare 


Un alt tip de date predefinit in Python şi care se poate dovedi foarte folositor este dicționarul. Dictionarele pot fi 
întâlnite şi în alte limbaje, sub alte nume, cum ar fi "memorii asociative” sau "valori asociative”. Spre deosebire 
de secvenţe (liste, şiruri, etc.) care sunt indexate cu numere (indicii sunt numere), dicționarele sunt indexate prin 
chei, care pot fi definite de oricare din tipurile de date invariabile(nemodificabile), de exemplu: şiruri de caractere 
sau numere. Perechile pot fi folosite drept chei ale unui dicţionar numai dacă conţin obiecte invariabile. Nu puteţi 
folosi drept chei listele deoarece acestea pot fi modificate folosind metode ca append () sau extend (). 


Este indicat să vă gândiţi la un dicţionar ca la o mulţime neordonată de perechi cheie-valoare, cu observaţia că 
o cheie trebuie să fie unică într-un dicţionar. O pereche de acolade crează un dicţionar gol: (). Puteţi crea un 
dicţionar dacă între acolade introduceţi o listă de perechi cheie:valoare, ale cărei elemente sunt separate prin 
virgulă, : dicţionar = (7 jack” :4098, 'Sape! :4139}.Aceata este, de asemenea, o modalitate de a 
scrie dicţionare la dispozitivul de ieşire. Operatiile principale pe care le realizează un dicţionar sunt: stocarea 
unei valori cu anumită cheie şi extragerea unei valori cunoscându-se o anumită cheie. O pereche cheie-valoare 
poate fi ştearsă folosind instrucţiunea del. Dacă se adaugă o valoare în dicţionare pentru o cheie care există deja, 
valoarea veche asociată acelei chei este pierdută. O eroare este generată, bineînţeles, dacă veţi încerca să extrageti 
o valoare pentru o cheie inexistentă. 


Metoda keys () a unui obiect dicţionar întoarce o listă cu toate cheile existente în respectivul dicţionar. Lista 
returnată nu este sortată, însă pentru a o sorta puteţi folosi metoda sort () a obiectului listă returnat de funcţie. 
Pentru a verifica dacă o anumită cheie se află deja în dicţionar folosiţi metoda has_key () . Iată un mic exemplu: 
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>>> tel = {’ jack’: 4098, 'sape': 4139) 
>>> tel[’guido’] = 4127 

>>> tel 
{’sape’: 4139, '’guido’: 4127, "jack: 4098} 
>>> tel[’ jack’ ] 


4098 

>>> del tel[’sape’ ] 
>>> tel[’irv’] = 4127 
>>> tel 


{’guido’: 4127, ‘irv’: 4127, ‘Jack’: 4098) 
>>> tel.keys () 

[’guido’, 'irv', ‘Jack’ ] 

>>> tel.has_key (’ guido’ ) 


5.6 Tehnici de parcurgere a secventelor 


Când se parcurge un dictionar, cheia si valoarea corespunzătoare se pot evidentia simultan utilizând metoda 
iteritems (). 


>>> knights = {’gallahad’: 'the pure’, “robin”: ‘the brave’ } 
>>> for k, v in knights.iteritems(): 
print k, v 


gallahad the pure 
robin the brave 


Când se parcurge o secvenţă, indexul poziţiei şi valoarea corespunzătoare se pot găsi simultan utilizând functia 
enumerate (). 


>>> for i, v in enumerate (['tic', 'tac', 'toe']): 
print i, v 

0 tic 

1 tac 

2 toe 


Pentru a parcurge două sau mai multe secvenţe in acelaşi timp intrările se pot imperechea cu functia zip (). 


>>> questions = [’name’, ‘quest’, 'favorite color’ ] 
>>> answers = [’lancelot’, “the holy grail’, 'blue'] 
>>> for q, a in zip(questions, answers): 

print 'What is your %s? It is Ss.’ $ (q, a) 
What is your name? It is lancelot. 
What is your quest? It is the holy grail. 
What is your favorite color? It is blue. 


Pentru a parcurge o secvenţă in ordine inversă, întâi se specifică secvenţa in ordine normală, apoi se apelează 
functia reversed(). 
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>>> for i in reversed(xrange(1,10,2)): 
print i 


= WWW 00 e 


Pentru a bucla o secvenţă în ordine sortată, se foloseşte funcţia sorted (), care returnează o nouă listă sortată, 
dar sursa rămâne nealterată. 


>>> basket = [’apple’, “orange”, 'apple', 'pear”, 'orange', ‘banana’ ] 
>>> for f in sorted (set (basket)): 
print f 
apple 
banana 
orange 
pear 


5.7 Mai multe despre condiţii 


Condiţiile folosite în cadrul instrucţiunilor while sau if pot conţine şi alti operatori decât cei de comparaţie. 


Operatorii de comparaţie in şi not in verifică dacă o anumită valoare se află sau nu într-o secvenţă dată. 
Operatorii is şi is not verifică dacă două obiecte sunt de fapt unul şi acelaşi obiect, acest lucru contează în 
cazul obiectelor modificabile cum sunt listele, de exemplu. 


Operatorii de comparaţie pot fi combinati. De exemplu a < == c testează întâi dacá a < b iar apoi dacă b 
este egal cu c. 


Condiţiile pot avea structuri foarte complexe dacă sunt folosiţi operatorii and, or sau not. Operatorii de com- 
paratie au aceeaşi prioritate care este mai mică decât aceea a operatorilor numerici. Operatorii logici, booleeni, 
and, or, not au cea mai mică prioritate, mai mică decât aceea a operatorilor de comparaţie. Cea mai mare 
prioritate între operatorii logici o au not, apoi and, iar cea mai mică or. În concluzie “A and not B or 
C” este echivalent cu “A and (not B) or C”. Bineînţeles, pentru claritate, puteţi folosi paranteze pentru a 
combina condiţiile şi. 


Operatorii logici mai sunt denumiți şi operatori “pe scurtătură” (shortcut operator), argumentele acestea sunt 
evaluate de la stânga la dreapta, şi evaluarea se opreşte odată ce rezultatul este determinat. De exemplu dacă A şi 
C sunt adevărate, iar B fals, expresia A and B and C nu este evaluată până la sfârşit, deci expresia C nu este 
evaluată pentru că ar fi inutil. 


Este posibilă atribuirea unei valori rezultate dintr-o comparaţie, sau orice altă condiţie, unei variabile: 


>>> stringl, string2, string3 = 11, 'Trondheim', ’Hammer Dance’ 
>>> non_null = stringl or string2 or string3 

>>> non_null 

' Trondheim! 


Spre deosebire de C, în Python nu sunt permise atribuirii în cadrul expresiilor. Programatorii de C pot critica acest 
lucru, dar prin aceasta se evită o mulţime de erori întâlnite în programele C, de exemplu = în loc de ==. 
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5.8 Compararea secventelor 


Obiectelor de tip secvenţă pot fi comparate cu obiecte secvenţă de acelaşi tip. Comparatiile între secvenţe folosesc 
principiile ordonarii lexicografice: se compară întâi primul element din fiecare listă. Dacă diferă este afişat rezul- 
tatul, dacă sunt egale se trece la compararea următoarelor două elemente, şi aşa mai departe până la epuizarea 
uneia dintre liste. Dacă elementele ce urmează a fi comparate sunt la râdul lor liste, compararea lexicografică 
are loc recursiv. Dacă toate elementele celor două liste sunt egale se consideră că listele sunt egale. Dacă una 
dintre secvenţe este o subsecventa inițială a celeilalte, atunci secvenţă mai scurtă este cea mai mică. Ordonarea 
lexicografica pentru şiruri foloseşte ordinea ASCII a caracterelor. Exemple de comparații între secvencte de acelaşi 
tip: 


(1, 2, 3) < (1, 2, 4) 

[1, 2, 3] < [1, 2, 4] 

"ABC! < 'C” < ‘Pascal’ < "Python! 

(l; 27 3 4) < (1, 2, 4) 

(1, 2) < (1, 2, -1) 

(1, 2, 3) == (1.0, 2.0, 3.0) 


(1, 2, ('aa', 'ab')) < (1, 2, ('abc', 'a'), 4) 


Python permite şi compara obiecte de tipuri diferite. Rezultatul este însă arbitrar: tipurile fiind ordonate după 
numele lor. În concluzie o listă va fi întotdeauna mai mică decât un şir, un şir mai mic decât o pereche, etc. 
Comparaţiile între numere se fac luând în consideraţie valoarea numerică chiar dacă numerele sunt de tipuri 
diferite, şi ca atare 0 va fi egal cu 0.0, etc. ? 


?Regulile de comparare între obiecte de tipuri diferite nu ar trebui considerate de foarte mare încredere; 
acestea pot fi schimbate la versiuni viitoare ale limbajului. 
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CAPITOLUL 
ŞASE 


Module 


Dacă ieşiţi din interpretorul Python şi intraţi din nou, definițiile pe care le-aţi făcut (funcţii, varibile, etc.) se 
pierd. Dacă aveţi de gând să scrieţi un program mai lung, ar fi mai bine să folosiţi un editor de texte pentru a 
scrie programul într-un fişier, şi apoi să rulati interpretorul Python cu parametru fişierul în care se află programul. 
Fişierul in care se află programul se numeşte script. Pe măsură ce programul se va mări veţi simţi nevoia să îl 
împărţiţi în mai multe fişiere. S-ar putea la fel de bine să doriţi să folosiţi o funcţie în mai multe programe fără a 
fi nevoit să copiaţi definiţia funcţiei în fiecare program. 


În Python puteţi scrie anumite definiţii într-un fişier, pe care apoi îl puteţi include în alte programe. Un astfel 
de fişier se numeşte modul. Definiţiile dintr-un modul pot fi importate în alte module, sau în modulul principal 
(programul iniţial). Un modul este un fişier care conţine definiţii şi instrucţiuni Python. Numele fişierului în 
care se află un anumit modul este dat de numele modulului şi extensia ”.py” la sfârşit. Într-un modul, numele 
acestuia este accesibil prin intermediul variabilei globale __name__. Folosiţi acum editorul dumneavoastră de 
texte preferat pentru a creea fişierul ’’fibo.py”: 


+ modul cu numerele lui Fibonacci 


def fib(n): + scrie sirul lui Fibonacci pana lan 
a, b= 0, 1 
while b < n: 
print b, 
a, b = b, atb 


def fib2 (n): # intoarce sirul lui Fibonacci pana la n 
result = [] 
a, b = 0, 1 
while b < n: 
result .append (b) 
a, b = b, atb 
return result 


Acum deschideţi interpretorul Python şi tastati comanda: 


>>> import fibo 


Această instrucțiune nu încarcă în tabela de simboluri numele funcțiilor definite în modulul fibo, ci numai numele 
modulului. Folosind numele modulului puteți accesa funcțiile definite în interiorul acestuia: 


>>> fibo.fib(1000) 

1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 
>>> fibo.fib2 (100) 

[Ay il Sy Dr Bi LS 2 BA 55; 89] 

>>> fibo.__name__ 

' fibo’ 


In cazul în care vă deranjează aceste nume lungi puteți proceda în felul următor: 
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>>> fib = fibo.fib 
>>> fib (500) 
1123 5 8 13 21 34 55 89 144 233 377 


6.1 Mai multe despre module 


Un modul poate contine atat instructiuni executabile cat si definitii de functii. Instructiunile sunt menite sa real- 
izeze initializarea modulului şi se execută o singură dată, atunci când modulul este importat! . 


Fiecare modul are propria sa tabelă de simboluri care este folosită de funcţiile definite în modul ca o tabelă de 
simboluri globală. 


Cu toate astea, autorul unui modul se poate folosi de variabilele globale, fără a-şi face griji pentru eventuale 
coliziuni cu variabilele globale ale mediului în care modulul va fi importat. Pe de altă parte dacă aveţi neapărat 
nevoie puteţi modifica direct variabilele globale ale unui modul, folosind aceeaşi convenţie ca la apelarea funcţiilor 
unui modul: modul .variabilă. 


Modulele pot importa alte module. Este indicat ca instrucţiunile import pot fi plasate la începutul programului 
si, dar nu este obligatoriu. 


Există o metodă de a încărca definițiile unui anumit modul direct în tabela de simboluri globală a modulului care 
importă: 


>>> from fibo import fib, fib2 
>>> fib (500) 
112 3 5 8 13 21 34 55 89 144 233 377 


În exemplul de mai sus numele modulului nu a fost introdus în tabela de simboluri locală (fibo nu este definit). 
Pentru a încărca toate definițiile modulului direct în tabela locală folosiţi sintaxa : 


>>> from fibo import * 
>>> fib(500) 
1 1 2 3 5 8 13 21 34 55 89 144 233 377 


Acum în tabela locală au fost încărcate toate numele de variabile şi funcţii din modul, mai putin cele care încep 
cu caracterul ”_”. 


6.1.1 Calea în care sunt căutate modulele 


Atunci când un modul numit ‘xxx’ este importat, interpretorul caută un fişier numit ‘xxx.py’ în directorul curent, 
si în toate directoarele specificate în variabila de stare PYTHONPATH. Aceasta are aceeaşi sintaxa ca şi variabila 
de sistem PATH, care este o listă de directoare. Dacă variabila PYTHONPATH nu este definită, sau modulul 
nu este gasit in directoarele din lista, atunci va fi căutat în directorul implicit de instalare, de obicei, in UNIX, 
“/usr/local/lib/python” . 


6.1.2 Fişiere Pyihon “compilate” 


Un important aport de viteză la pornirea programelor care încarcă o mulțime de module standard este adus de 
următorul comportament al Python-ului: dacă în directorul unde este găsit fişierul “xxx.py” se mai află şi ‘xxx.pyc’, 
se presupune că acest ultim fişier conţine o variantă compilată a modulului şi este încărcat în loc de ‘xxx.py’. 


'De fapt declaraţiile de funcţii sunt tot ’instructiuni’ care sunt ’executate’ : execuţia inseamnă încărcarea numelui funcţiei în tabela de 
simboluri globale a modulului. 
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Timpul la care a fost modificat ultima oară fişierul “.py” este înregistrat în fişierul ‘.pyc’ în momentul în care este 
creat, iar în momentul importului dacă aceste momente de timp nu corespund fişierului “.pyc” este ignorat. 


De obicei nu trebuie să faceţi nimic deosebit pentru a crea fişierul “xxx.pyc’. Ori de câte ori “xxx.py’ este compilat 
cu succes este creat sau suprascris şi fişierul “xxx.pyc’. Dacă scrierea fişierului compilat nu reuşeşte veţi fi avertizat 
printr-un mesaj de eroare. Conţinutul fişierelor de tip “.pyc” este independent de platformă, astfel încât Python 
devine un limbaj foarte portabil. 


Câteva indicaţii pentru experți: 


e Când interpretorul Python este apelat folosind opţiunea -O, se generează cod optimizat care va fi stocat în 
fişiere de tip ‘.pyo’. La momentul actual optimizatorul nu este de prea mare folos, nu face decât să elimine 
din cod instrucţiunile assert şi SET-LINENO. Atunci când se foloseşte această opţiune tot codul este 
optimizat, fişierele ‘.pyc’ sunt ignorate iar fişierele “.py” sunt compilate şi optimizate. 


e Dacă interpretorul Python este lansat în execuţie folosind opţiunea -OO, compilatorul va genera cod opti- 
mizat, care în cazuri rare să ducă la fuctionári eronate ale programului. În mod curentă se elimină numai 
şirurile __doc___ din codul compilat, rezultând fişiere “.pyo” mai compacte. Din moment ce unele pro- 
grame pot folosi aceste şiruri, eliminarea lor ar putea genera erori. În concluzie, ar trebui să folosiţi această 
opţiune numai atunci când ştiţi foarte bine ce faceți. 


e Un program nu funcţionează mai rapid, atunci când este citit dintr-un fişier de tip ‘.pyc’ sau .pyo, fata de 
unul ‘.py’. Singurul lucru care diferă este viteza de încărcare a programelor în memorie. 


e Atunci când este rulat un script, prin lansarea interpretorului avînd ca parametru numele fişierului în care se 
află script-ul, codul script-ului nu este compilat şi nu se generează fişiere de tip ‘.pyc’ sau “.pyo”. În cazul 
în care aveţi un script de dimensiuni mari, şi doriţi să cresteti viteza de încărcare, puteţi să mutaţi bucăţi din 
cod într-un modul pe care să îl importati apoi în script. Interpretorul Python poate fi lansat şi folosind direct 
un fişier cu extensia “.pyc” sau ‘.pyo’. 


e Este posibil să lansați interpretorul Python doar cu un fişier de tip ‘xxx.pyc’ (sau ‘xxx.pyo’ dacă se foloseşte - 
O), fără ca fişierul ‘xxx.py’ asociat sá existe. Puteţi folosi această facilitate atunci când distribuiţi o bibliotecă 
într-un format de cod greu de decriptat. 


e Modulul compileall poate fi folosit pentru a crea fişiere ‘.pyc’ (sau ‘.pyo’, utilizând -O) pentru toate 
modulele dintr-un director. 


6.2 Module standard 


Python dispune de o bilbliotecá de module standard, a căror descriere o puteţi găsi în "Python Library Reference”. 
Unele module sunt integrate în interpretor, deşi nu fac parte din nucleul limbajului, din definiţia acestuia, dar 
sunt integrate pentru eficienţă sau pentru a facilita accesul la primitivele sistemului de operare. Setul de module 
integrate este o optiune de configurare, care de asemenea depinde de particularitatea platformei. De exemplu 
modulul amoeba este disponibil pe sisteme care pun la dispoziţie primitive Amoeba. Un anumit modul necesită 
o atenţie specială: sys care este integrat în orice interpretor Python. Variabilele sys.ps1 şi sys .ps2 definesc 
şirurile de caractere ce vor fi folosite de interpretor pentru prompt-ul principal şi cel secundar: 


>>> import sys 
>>> sys.psl 
">>> / 


>>> sys.ps2 
Psi cauta i 


>>> sys.psl = ’C> ’ 
C> print. Yuck!’ 
Yuck! 

C> 
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Aceste două variabile sunt definite doar dacă interpretorul se află în mod interactiv. Variabila sys .path conţine 
o lisă de directoare unde Python caută module. Această variabilă este initializata din variabila de sistem PYTHON- 
PATH, sau cu o valoare implicită în cazul in care PYTHONPATH nu este definită. Puteţi modifica sys.path 
folosind operaţii specifice listelor: 


>>> import sys 
>>> sys.path.append(’ /ufs/guido/lib/python’ ) 


6.3 Funcția dir () 


Funcţia integrată dir () poate fi folosită pentru a determina ce nume (de variabile, funcţii, etc.) defineşte un 
modul. Rezultatul acestei funcţii este o listă sortată de şiruri de caractere: 


>>> import fibo, sys 

>>> dir(fibo) 

[’__name__’, 'fib', 'fib2’] 

>>> dir(sys) 

[’__displayhook__’, ’__doc__’, ’__excepthook__’, ’__name__’, '_ _stderr_ ', 

E stdin__*, ? stdout__’, '_getframe', 'api_version', 'argv', 
‘builtin_module_names’, 'byteorder”, 'callstats”, 'copyright', 
'displayhook', 'exc_clear', 'exc_info', 'exc_type', 'excepthook', 
'exec_prefix', 'executable', 'exit', 'getdefaultencoding', ’getdlopenflags’, 
'getrecursionlimit', 'getrefcount', 'hexversion”, 'maxint”, 'maxunicode', 
'meta_path', 'modules”, 'path”, "path _hooks', ‘’path_importer_cache’, 
‘platform’, 'prefix’, 'psl', 'ps2”, 'setcheckinterval’, 'setdlopenflags', 
'setprofile', 'setrecursionlimit”, 'settrace', 'stderr”, ‘stdin’, '’stdout’, 
‘version’, 'version_info', 'warnoptions’ ] 


Dacă funcţia dir () este apelata fără argumente, va lista numele ce sunt definite (local) până în momentul curent: 


>>> a = [1, 2, 3, 4, 5] 

>>> import fibo, sys 

>>> fib = fibo.fib 

>>> Gard 

[’__name__’, 'a', 'fib', 'fibo’, 'sys'”] 


Observati că listează diferite tipuri de nume: variabile, funcţii, module, etc. 


dir () nu listează şi numele de funcţii sau variabile integrate. Dacă doriţi o astfel de listă, puteţi apela dir (_- 
_builtin___),unde___buildin__ este modulul în care se află funcţiile şi variabilele integrate: 
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>>> import __builtin 
>>> dir(__builtin__) 
[’ArithmeticError’, 
‘DeprecationWarning’, 
Exception’, 'False', 
IndentationError’, 
‘LookupError’, 'MemoryError', 
‘NotImplementedError’, 
’PendingDeprecationWarning’, 
'RuntimeWarning', 'StandardError', 
' SyntaxWarning', 'SystemError', 
‘True’, 'TypeError', 
‘'ValueError’, 'Warning', 
‘ import__', '_ name ‘abs’, 
‘callable’, 'chr', 'classmethod', 
‘copyright’, ‘credits’, 'delattr', 
‘enumerate’ ‘eval’, “execfile', 
'getattr', 


FÉ 

'globals’, 'hasattr', 
‘input’, ‘int’, 'intern', 
‘len’, ‘license’, ‘list’, “locals” 
‘object’, 'oct', ‘open’, ‘ord’, 
‘range’, ‘’raw_input’, 'reduce', 
'setattr', 'slice', 
‘tuple’, ‘type’, 


, 


EOFError', 


, 


, 


"IndexError'”, 


‘OSError’, 


Lă 
La 


‘staticmethod’ 
‘unichr’, 
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‘AssertionError’, 
'FloatingPointError’, 
"NameError', 
'"ReferenceError', 
'SystemExit’, 
‘UnboundLocalError’, 


'ZeroDivisionError’, 
‘apply’, 


‘exit’, 
‘hash’, 
‘isinstance’, 


Pow”, 
'reload', 


‘unicode’, 


‘AttributeError’, 
‘Ellipsis’, 'EnvironmentError', 


'FutureWarning’, *IOError', 
'KeyError’, 'KeyboardInterrupt', 
“None”, ‘NotImplemented’, 
'OverflowError', '*OverflowWarning', 
'RuntimeError!? , 
'Stoplteration', 'SyntaxError', 

' TabError! , 
‘UnicodeError’, 


‘Import! 


, 


UserWarning', 
id debug__’, *__doc_ ', 
"basestring', 'bool”, ‘buffer’, 
‘comp’, ‘coerce’, 'compile', 'complex', 
‘dict’, 'dir”, ‘'divmod’, 

file! (filter, "float! 
‘help’, ‘hex’, ‘id’, 
“issubclass', ‘iter’, 
‘long’, ‘map’, 'max”, ‘min’, 
‘property’, 'quit', 
‘repr’, ‘round’, 
‘str’, ‘sum’, ‘super’, 
‘vars’, 'xrange', 'zip'] 


, 


La 
r 


, 


La 


Pachetele sunt o modalitate prin care Python structurează modul de acces la module (si la definițiile existente în 


module). Pentru exemplificare numele modulului A. 1 
“A”. 


B desemnează un submodul ‘B’ definit în cadrul pachetului 


Să presupunem că doriţi să proiectaţi o colecţie de module (un pachet) pentru manipularea fişierelor de sunet, şi a 
sunetelor. Există o multitudine de formate de sunet (de obicei recunoscute după extensia lor ‘.wav’, “.aiff', au”) 
aşa că este necesară crearea şi întreţinerea unei colecţii de module în continuă creştere care să permită conversia 
între diverse formate de fişiere. Există multe alte operaţii pe care poate aţi dori să le executaţi (mixaje, adăugarea 
ecoului, efecte stereo, etc.), aşa că, de fapt, veţi scrie o serie nesfârşită de module care să permită aceste operaţii. 
Aveţi mai jos o posibilă structură a pachetului dumneavoastră (în sensul unei ierarhii de fişiere): 
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Error’, 


Sound/ Pachet "tata" 
__init__.py Initializarea pachetului ’ sound’ 
Formats/ Subpachet pentru conversii intre fisiere 
__init__.py 
wavread.py 
wavwrite.py 
aiffread.py 
aiffwrite.py 
auread.py 
auwrite.py 


Effects/ Subpachet pentru efecte acustice 
__init__.py 

echo.py 

surround.py 

reverse.py 


Filters/ Subpachet pentru filtre 
__init__.py 
equalizer.py 
vocoder.py 
karaoke.py 


Fisierele de tipul ‘__ init__.py’ sunt necesare pentru a face Python să trateze directoarele ca pachete. Acestea 
sunt necesare pentru a preveni situaţia ca un director cu un nume comun, de exemplu string, să ascundă un 
modul valid cu acelaşi nume. În cel mai simplu caz ‘__init.py__’ poate fi un fişier gol, dar poate conţine şi cod de 
iniţializare. 


Utilizatorii unui pachet pot importa doar un anumit modul din cadrul pachetului: 


import Sound.Effects.echo 


Instrucţiunea de mai sus a încărcat submodulul Sound.Effects.echo. O funcţie continuta de submodul 
trebuie aplelată folosindu-i numele întreg. 


Sound.Effects.echo.echofilter(input, output, delay=0.7, atten=4) 


O alternativa pentru a importa un modul este: 


from Sound.Effects import echo 


În acest moment numele definite în modul au fost încărcate în tabela locală de simboluri, deci numele de funcţii 
şi variabile sunt disponibile fără prefix: 


echo.echofilter(input, output, delay=0.7, atten=4) 


O altă variantă este încărcarea (importarea) directă a funcţiei sau variabilei dorite: 


from Sound.Effects.echo import echofilter 


Aici se încarcă, de asemenea, submodulul echo, dar fuctia echofilter () poate fi accesat direct : 


echofilter(input, output, delay=0.7, atten=4) 
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De observat că atunci când se foloseşte sintaxa from packet import element, elementul poate fi, fie un sub- 
modul (sau subpachet), fie un nume definit în pachet, de exemplu un nume de funcţie sau variabilă, sau un nume 
de clasă. 


Instrucţiunea import testează întâi dacă elementul este definit sau nu în pachet. Dacă elementul nu este definit, 
Python presupune că este vorba de un modul şi încearcă să-l încarce. Dacă încărcarea nu reuşeşte este generată o 
excepţie de tipul ImportError. 


Când folosiţi o sintaxă de genul: import element. subelement . subsubelement, fiecare element, mai 
puţin ultimul trebuie obligatoriu să fie un pachet. Ultimul element poate fi un modul, un pachet, dar nu poate fi o 
clasă, o funcţie, o variabilă, etc. definită în elementul anterior. 


6.4.1  Importarea tuturor modulelor dintr-un pachet 


Ce se va întâmpla dacă un programator va folosi o instrucţiune de genul: from Sound.Effects import 
* ? Într-un caz ideal, programatorul ar putea să spere că interpretorul Python va realiza o căutare recursivă în 
sistemul de fişiere şi directoare după modulele existente în pachet. Din nefericire nu funcţionează foarte bine 
pe platforme Mac sau Windows, din varii motive. Pe astfel de platforme existenţa unui fişier ‘ECHO.PY’ nu 
garantează că în acest fişier se află un modul numit Echo, cât şi echo sau ecHo, şi aşa mai departe. Spre 
exemplu Windows 95 are prostul obicei de a afişa numele de fişiere cu prima literă mare. Sistemul de fişiere DOS 
8+3 ridică o altă piedică în calea numelor lungi de module. 


Singura soluţie pentru astfel de probleme este ca autorul pachetului să specifice exact ce module există în pachet. 
Instrucţiunea import () foloseşte următoarea convenţie: dacă codul existent în fişierul *__init__.py” defineşte 
o listă cu numele __all__, aceasta este considerată lista cu modulele ce ar trebui încărcate la execuţia unei 
instrucţiuni from pachet import x. Este obligaţia autorului pachetului să modifice lista atunci când este 
cazul. Autorii de pachete pot lua, de asemenea, decizia de a nu defini această listă, dacă nu vor ca programatorul 
care foloseşte pachetul să execute instrucţiuni de genul import x. Fişierul ‘Sounds/Effects/__init__.py’ ar trebui 
să conţină următoarele: 


all__ = ["echo", "surround", "reverse"] 


In acest caz instrucţiunea from Sound.Effects import * ar încărca cele trei submodule ale modulului 
Sound. 


Dacă variabila ___a11___ nu este definită, instrucţiunea de import nu va importa toate submodulele ci va importa 
numai pachetul Sound.Effects (eventual va executa codul de initializare din ‘__init__.py’) şi apoi va importa 
toate numele definite în pachet. Se vor importa şi submodulele pachetului dacă acest lucru este specificat prin 
instrucţiuni import. Priviţi următorul cod : 


import Sound.Effects.echo 
import Sound.Effects.surround 
from Sound.Effects import x 


În exemplul anterior, modulele echo şi surround sunt importate în spaţiul numeleor curent deoarec sunt definite in 
pachetul Sound.Effects când instrucţiunea from .. . import este executată ( acest lucru funcţionează şi 
când se defineşte _all__). 


Nu este foarte eficient să folosiţi instrucţiuni de tipul import x, pentru că în acest fel codul dumneavoastră 
va deveni ambiguu, nefiind clar care anume module sunt încărcate. Totuşi dacă aţi lansat interpretorul în mod 
interactiv, puteţi folosi astfel de instrucţiuni pentru a evita scrierea multor instrucţiuni. 


In concluzie nu este nimic greşit în folosirea unei instrucţiuni similare cu from Packet import submodul, 
aceasta fiind şi sintaxa recomandată. 


6.4.2 Referentieri între pachete 


Apare deseori necesitatea ca într-un submodul să se folosească cod dintr-un alt submodul. De exemplu modulul 
surround s-ar putea folosi de modulele echo. De fapt astfel de referinţe sunt atât de întâlnite încât instrucţiunea 


6.4. Pachete 43 


import examinaeză întâi pachetul “cel mai cuprinzător”, şi apoi caută în lista de directoare. Cu toate acestea 
modulul surround poate folosi mult mai simplu o instrucţiune import echo sau from echo import 
echofilter. Dacă modulul ce se doreşte importat nu se află în pachetul curent, instrucţiunea import caută “mai 
sus” în ierarhia de module a pachetului. 


Atunci când pachetele sunt strucuturate în subpachete, nu există o modalitate de a prescurta referir- 
ile la alte submodule, ci trebuie folosite numele întregi ale subpachetelor. De exemplu dacă modulul 
Sound.Filters.vocoder are nevoie de modulul echo din pachetul Sound.Effects, poate folosi in- 
structiunea: from Sound.Effects import echo. 


6.4.3 Pachete în directoare multiple 


Pachetele suporta un atribut special, __path__.Acest atribut este initializat ca o lista care conţine numele 
directorului în care se găseşte *__init.py__'—ul pachetului înainte de executarea codului din fişier. Această 
variabilă se poate modifica, făcându-şi efectul pentru viitoarele căutări de module şi subpachete conţinute în 
pachet. 


Cât timp această componentă nu se utilizează prea des, se poate folosi pentru extinderea setului de module găsite 
in pachet. 
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CAPITOLUL 
ŞAPTE 


Intrări şi ieşiri 


Există câteva modalităţi de a prezenta rezultatele unui program. Datele pot fi afişate într-un format care poate fi 
înţeles de utilizator, sau pot fi scrise într-un fişier pentru a putea fi prelucrate mai târziu. Acest capitol va explica 
câteva dintre posibilităţi. 


7.1  Formatarea elegantă a datelor de ieşire 


Până acum am întâlnit două metode de a afişa valori: instrucţiunea print şi expresii. (O a treia metodă este 
folosind metoda write () a obiectelor de tip fişier. Fişierul standard de ieşire este referit ca “sys.stdout’.) 


Adesea veţi dori să aveţi mai mult control asupra modului de afişare a valorilor. Există două metode pentru a 
controla modul de afişare: prima este să modificaţi singur un şir de caractere, folosind diversele operaţii existente, 
iar apoi să îl afişaţi. Modulul st ring conţine câteva operaţii utile pentru manipularea şirurilor de caractere. O a 
doua metodă este folosirea operatorului %, cu un şir, ca argument stânga. Operatorul % interpretează argumentul 
stânga în acelaşi mod ca şi şirul de formatare al funcţiei C sprintf () aplicându-l asupra argumentului din 
dreapta şi returnând şirul rezultat în urma ecestei formatări. O singură întrebare rămâne: cum pot fi convertite 
valorile în şiruri de caractere ? Din fericire Python poate converti orice tip de valoare în şir de caractere: fie prin 
funcţia repr (), fie scriind valoarea între apostroafe (“). lată câteva exemple: 


>>> s = "Hello, world.’ 

>>> str(s) 

"Hello, world.’ 

>>> repr (s) 

"Hello, world.'" 

>>> str(0.1) 

"Oa 

>>> repr (0.1) 

'0.10000000000000001’ 

>>> x = 10 x 3.25 

>>> y = 200 x 200 

>>> s = 'The value of x is ’ + repr(x) + ’, and y is ’ + repr(y) + '...” 

>>> print s 

The value of x is 32.5, and y is 40000... 

>>> # The repr() of a string adds string quotes and backslashes: 
hello = "hello, world\n’ 

>>> hellos = repr (hello) 

>>> print hellos 

"hello, world\n’ 

>>> # The argument to repr() may be any Python object: 
repr((x, y, (’spam’, 'eggs'))) 

"(32.5, 40000, (’spam’, ’eggs’))" 

>>> # reverse quotes are convenient in interactive sessions: 

si x, Y, ('"spam', 'eggs'”)' 

"(32.5, 40000, (’spam’, 'eggs'))" 


x 


Iată două modalităţi de a genera un tabel cu pătratele şi cuburile numerelor naturale: 
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>>> import string 

>>> for x in range(1, 11): 
print string.rjust(*x*, 2), string.rjust (xxx, 3), 
+ Observati ultimul caracter "," de pe ultima linie 
print string.rjust('xx*x*x", 4) 


1 1 d 
2 4 8 
3 9 27 
4 16 64 
5 29 125 
6 36 216 
7 49 343 
8 64 512 
9 81 729 
10 100 1000 


>>> for x in range(1,11): 
print '$2d %3d %4d” % (x, XxX, X*X*xX) 


1 1 1 
2 4 8 
3 9 27 
4 16 64 
5 25 125 
6 36 216 
7 49 343 
8 64 512 
9 81 729 
10 100 1000 


Observati că între coloane a fost adăugat un spaţiu. Acest comportament este asigurat de modul în care lucrează 
instrucţiunea print: întotdeauna adaugă un spaţiu între argumentele sale. 


Acest exemplu demonstrează utilizarea funcţiei string.rjust (), care aliniază la dreapta un şir de caractere, 
într-un câmp a cărui dimensiune este dată de utilizator, introducând spaţii la stânga şirului. Există şi alte funcţii 
similare string. just (), string.center (). Aceste funcţii nu afişează nimic, nu fac decât să returneze 
un alt şir de caractere. Dacă şirul primit este mai lung, aceste funcţii nu îl modifică, ci îl returnează intact. Acest 
mecanism probabil că vă va strica aranjarea pe coloane, dar este o variantă preferabilă celeilalte, adică trunchierea 
şirului. Dacă doriţi să truchiati un şir, puteţi oricând să folosiţi operaţiile de portionare (slicing), ca de exemplu: 
string.ljust (x,n) [0:n]. 


Mai există o funcţie utilă, care ”umple” cu zero-uri un sir, adăugându-le la stânga șirului original, până când acesta 
ajunge la o anumită dimensiune. Această funcţie este string.zfill(): 


>>> import string 

>>> string.zfill(’12’, 5) 

”000127 

>>> string.zfill(’-3.14’, 7) 
'-003.14’ 

>>> string.zfill(’3.14159265359’, 5) 
"3.14159265359" 


Folosind operatorul % ar arăta astfel: 


>>> import math 
>>> print 'Valoarea lui PI este aprox. %5.3f.’ % math.pi 
Valoarea lui PI este aprox. 3.142. 


Dacă există mai multe formatari în şir, trebuie să se transmita ca operator dreapta o pereche ( tupla ), astfel : 
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>>> table = {’Sjoerd’: 4127, 'Jack’: 4098, 'Dcab': 7678} 
>>> for name, phone in table.items(): 


print '$-10s ==> %10d’ $ (name, phone) 
Jack ==> 4098 
Dcab ==> 7678 
Sjoerd ==> 4127 


Majoritatea tipurilor de formate functioneaza exact ca in C, si nu necesita decat transmiterea corecta a operandului 
din dreapta. Nerespectarea acestei reguli va genera 0 exceptie. Specificatorul de format %s este mai flexibil, daca 
parametrul asociat din partea dreaptă nu este de tip şir de caractere, va fi automat convertit la şir de caractere 
folosind funcţia integrată str () . Specificatorii de format %u şi %p din C nu sunt acceptaţi şi de Python. 


Dacă aveţi un şir lung pe care nu doriţi să-l împărţiţi în mai multe şiruri, ar fi interesant să vă puteţi referi la vari- 
abile prin nume în loc de poziţie. Acest lucru poate fi realizat folosind modalitatea numevariabilă format, 
ca înurmatorul exemplu : 


>>> table = {’Sjoerd’: 4127, 'Jack’: 4098, 'Dcab': 8637678} 
>>> print 'Jack: %(Jack)d; Sjoerd: %(Sjoerd)d; Dcab: %(Dcab)d’ $ table 
Jack: 4098; Sjoerd: 4127; Dcab: 8637678 


Acest lucru se poate dovedi foarte util atunci cand doriţi să afisati variabilele predefinite folosind funcţia vars () 
care întoarce un dicţionar cu toate variabilele locale. 


7.2 Citirea şi scrierea fişierelor 


Funcţia open () are ca rezultat un obiect de tip fişier, şi este de cele mai multe ori apelată cu doi parametrii: 
numele de fişier şi modul de acces la fişier: 


>>> f=open(’/tmp/workfile’, 'w”) 
>>> print f 
<open file '/tmp/workfile”, mode 'w” at 80a0960> 


Primul argument este un sir de caractere care conţine numele fişierului ce urmează să fie deschis. Al doilea 
argument este tot un şir de caractere ce conţine doar câteva caractere ce descriu modul în care fişierul va fi utilizat. 
Modul poate fi: 


- “7” = fişierul va putea fi numai citit 
- °w = fişierul va putea fie doar scris (în cazul în care un fişier există deja, acesta va fi suprascris) 


- “a” = fişierul va fi deschis pentru actualizare (toate datele scrise vor fi adăugate la sfârşitul fişierului) 


> 


- *r+’ = în fişierul ce va fi deschis se pot executa atât operaţii de scriere cât şi de citire. 


Pe Windows si Macintosh adăugarea caracterului *b’, la sfârşitul șirului prin care se specifică modul de acces, 
indică interpretorului Python să deschidă fişierul în mod binar. Există deci modurile de acces ’rb, ’wb’, ’r+b’. 
Windows face distincţie între fişierele de tip text şi cele binare: caracterele de sfârşit de linie sunt modificate 
atunci când se scriu sau se citesc date. Aceaste modificări "din spatele scenei” sunt binevenite în cazul fişierelor 
text, dar nu pot face decât rău în cazul fişierelor binare cum sunt . JPG sau .EXE de exemplu. Aveţi deci grijă să 
folosiţi modul binar când lucraţi cu astfel de fişiere. 
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7.2.1 Metodele obiectelor fişier 


Exemplele acestei secţiuni vor presupune că un obiect *f” de tip fişier a fost deja creat, deci fişierul a fost deja 
deschis. 


Pentru a citi conţinutul unui fişier apelati f . read (dimensiune), care citeşte o cantitate de date şi o returnează 
ca string. Parametrul dimensiune este opţional. Atunci când acest parametru este omis sau este negativ, întregul 
fişier va fi citit şi returnat ca şir de caractere. Apare o problemă, bineînţeles, dacă memoria maşinii dumneavoastră 
este mai mică decât dimensiunea fişierului. Dacă parametrul dimensiune este transmis funcţiei, atunci din fişier 
vor fi citiţi cel mult atâţia octeți câţi sunt specificaţi prin acest parametru. 


Dacă s-a ajuns la sfârşitul fişierului f . read () va returna un şir vid(" "): 


>>> f.read() 
"This is the entire file.\n’ 


>>> f.read() 


Metoda f . readline () citeşte o singură linie din fişier. Un caracter "linie noua’ (newline), ”\n”, este adăugat 
la sfârşitul fiecărui şir. Acest caracter este omis dacă este vorba despre ultima linie din fişier şi dacă acesta nu se 
termină cu un caracter "linie nouă”. Toate acestea fac rezultatul neclar. Dacă rezultatul este un sir gol, atunci a 


fost atins sfârşitul fişierului, în timp ce dacă rezultatul este doar caracterul ”\n” înseamnă că din fişier a fost citită 
o linie goală: 


>>> f.readline() 

"This is the first line of the file. n! 
>>> f.readline() 

"Second line of the file\n’ 


>>> f.readline() 
rr 


Metoda f . readlines () a obiectelor de tip fişier, întoarce o listă conţinând toate liniile din fişier. Dacă metoda 
este apelată cu argumentul dimensiune, atunci din fişier sunt citiţi atâţia octeți câţi sunt specificaţi prin acest 
parametru şi încă atâţia octeți câţi sunt necesari pentru a completa o linie. Această metodă este folosită pentru 
citirea eficientă pe linii a fişierelor de dimensiuni mari fără a întâmpina dificultăţi cu memoria. Vor fi returnate 
numai linii complete: 


>>> f.readlines () 
[' This is the first line of the file. n', 'Second line of the file\n’] 


Metoda f . write (sir) scrie conţinutul șirului de caractere în fişier, întorcănd, ca rezultat, None: 


>>> f.write('This is a test\n’) 


Daca se doreşte scrierea a altceva dacat şir de caractere, atunci, mai îtâi, acesta trebuie convertit in şir : 


>>> value = (’the answer’, 42) 
>>> s = str(value) 
>>> f.write(s) 


Metoda f.tell() are ca rezultat un număr întreg reprezentând poziţia cursorului în fişier, poziţie 
măsurată în octeți faţă de începutul fişierului. Pentru a schimba poziţia cursorului folosiţi metoda 
f .seek (deplasare, referinţă). Noua poziţie este calculată în felul următor: cursorul va fi deplasat 
cu deplasare octeți, faţă de începutul fişierului dacă referinţă este 0, fata de poziţia curentă a cursorului 
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dacă referinţă este 1 şi fata de sfârşitul fişierului dacă referinţă este 2. Dacă al doilea parametru este 
omis, valoarea lui implicită va fi 0, deci punctul de referinţă va fi începutul fişierului: 


>>> f=open(’/tmp/workfile’, 'r+') 

>>> f.write(’0123456789abcdef’ ) 

>>> f.seek (5) # Salt la al 5-le byte din fisier 
>>> f.read(1) 

CEF 
>>> 
>>> 
ra' 


lau) 


„seek (-3, 2) # Salt la al 3-lea byte de la sfarsitul fisierului 
„read (1) 


lau) 


Când terminati lucrul cu un fişier, acesta trebuie închis folosind £.close(). După închiderea fişierului orice 
încercare de operaţie asupra fişierului va eşua: 


>>> f.close() 
>>> f.read() 
Traceback (most recent callk last): 
File "<stdin>", line 1, in ? 
ValueError: I/O operation on closed file 


Obiectele fişier poseadá şi alte metode, cum ar fi isatty () şi truncate () care sunt mai putin folosite. 
(Consultaţi "Python Library Refference" pentru mai multe detalii). 


7.2.2 Modulul pickle 


Şirurile de caractere pot fi citite şi scrise foarte uşor dintr-un, respectiv într-un fişier. Cu numerele lucrurile se 
complică putin. Ati putea să transformați, înainte de scrierea în fişier, numărul în string, apoi să îl scrieţi, iar la 
citire sá îl transformați înapoi în număr. Un astfel de mecanism este complet ineficient. 


Pentru aceste situaţii, şi altele mult mai complexe, Python dispune de modulul pickle care poate transforma 
orice obiect Python într-un string. Acest proces se cheamă pickling, denumirea procesului invers se numeşte 
unpickling. Între aceste două proceduri string-ul poate fi salvat într-un fişier, transmis în reţea, etc. 


Cea mai simplă metodă de a salva un obiect într-un fişier este următoarea: 


pickle.dump (x, f) 


lar pentru a încărca un obiect dintr-un fişier: 


x = pickle.load(f) 


Există şi alte metode de a transforma un obiect într-un şir fără a-l salva într-un fişier. Pentru mai multe detalii 
consultaţi “Python Library Refference”. 


Prin procedeele de ‘pickling’ şi ‘unpickling’, pickle poate stoca obiecte ce pot fi apoi reutilizate. Termenul 
tehnic pentru un astfel de obiect este obiect persistent. Deoarece aceste metode sunt foarte des folosite, program- 
atorii care creează extensii ale limbajului Python au grijă ca tipurile de date nou definite să poată fi salvate şi 
încărcate corect(mai bine zis să se comporte corect în procesul de ‘pickling’ şi apoi ‘unpickling’). 
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CAPITOLUL 
OPT 


Erori şi excepții 


Până acum erorile au fost doar menţionate, dar dacă aţi încercat exemplele prezentate probabil aţi şi întâlnit câteva 
dintre ele. Există (cel puţin) două categorii de erori: erori de sintaxă şi excepţii. 


8.1 Erori de sintaxă 
Erorile de sintaxă sunt cel mai des întâlnite, atâta timp cât sunteţi un începător în limbajul Python: 


>>> while 1 print "Hello world’ 
File "<stdin>", line 1, in ? 
while 1 print ’Hello world’ 


A 


SyntaxError: invalid syntax 


Interpretorul reproduce linia care a cauzat eroarea şi afişează o săgeată în dreptul instructinii care a generat-o. 
Eroarea este cauzată (sau cel putin detectată) de instrucţiunea dinaintea ságetii. În exemplul de mai sus eroarea 
este generată de instrucţiunea print, deoarece înaintea acestei instrucţiuni ar trebui să existe un caracter ’:’. 
Numele fişierului şi numărul liniei care a generat eroarea sunt afişate, astfel încât dacă eroarea provine dintr-un 
script să o puteţi corecta cât mai comod. 


8.2 Exceptii 


Chiar dacă o expresie sau o instrucţiune este corectă din punct de vedere sintactic, aceasta poate genera o eroare 
în momentul în care este executată. Erorile generate (detectate) în timpul execuţiei se numesc excepţii şi nu sunt 
neapărat fatale. Veţi întreba cum puteţi evita astfel de erori utilizând limbajul Python. 


Majoritatea excepțiilor nu sunt tratate de program şi generează mesaje de eroare ca în exemplul de mai jos: 


>>> 10 * (1/0) 
Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
ZeroDivisionError: integer division or modulo by zero 
>>> 4 + spamx*3 
Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
NameError: name ’spam’ is not defined 
>>> T27- 2 
Traceback (most recent call last): 
File "<stdin>", line 1, in ? 
TypeError: cannot concatenate 'str' and 'int' objects 


Ultima linie a mesajului de eroare indică ce s-a întâmplat. Exceptiile sunt de diferite tipuri, iar tipul excepţiei este 
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de asemenea afişat în corpul mesajului de eroare. În exemplul anterior: ZeroDivisionError, NameError şi 
TypeError, desemnează tipul excepţiei. Şirul afişat este un nume predefinit pentru respectivul tip de excepţie. 
Acest lucru este valabil pentru toate excepţiile predefinite, dar se pot defini şi alte tipuri de exceptii.Numele 
excepțiilor standard sunt identificatori predefiniti, nu cuvinte rezervate. 


A doua parte a liniei reprezintă detaliile excepţiei, descriind mai bine ce s-a întâmplat. 


În Python Library Reference sunt listate excepţiile implicite şi semnificaţiile lor. 


8.3 Tratarea excepțiilor 


Este posibil să scrieţi programe care tratează anumite tipuri de excepţii . În următorul exemplu este implementată 
o buclă care cere utilizatorului introducerea unui număr. Bucla este întreruptă în momentul în care utilizatorul 
introduce un număr corect, altfel procesul de introducere continuă. Procesul poate fi întrerupt folosind combinaţia 
de taste *'CTRL-C”. Dacă utilizatorul foloseşte această combinaţie de taste, programul este întrerupt, dar înainte 
este generată excepţia: KeyboardInterrupt: 


>>> while 1: 
try: 
x = int (raw_input ("Please enter a number: ")) 
break 
except ValueError: 
print "Oops! That was no valid number. Try again..." 


Instructiunea t ry functioneaza in felul urmator: 


+ Întâi sunt executate instrucţiunile din blocul try (blocul de instrucţiuni dintre instrucţiunile try şi except). 


e Dacă nu este generată nici o excepţie, instrucţiunile din blocul except nu sunt executate şi programul con- 
tinuă. 


e Dacă apare o excepţie în timpul execuţiei instrucţiunilor din blocul t ry rstul instrucţiunilor din acest bloc 
sunt sărite. Dacă tipul excepţiei este acela pe care îl tratează şi blocul except, atunci sunt executate in- 
strufiunile din acest bloc. După ce excepţia este tratată, execuţia programului continuă cu instrucţiunile ce 
urmează instrucţiunii t ry. 


e Dacă excepţia generată nu este prevăzută între excepţiile tratate în blocul except, ea este transmisă în 
afara blocului try.Dacá nu este găsit un bloc except care să trateze excepţia, aceasta va fi o excepție 
netratată. Programul este întrerupt, afişând mesajul : unhandled exception. 


O instrucţiune try poate avea mai multe clauze except, implementând astfel mai multe tipuri de "tratament! 
pentru mai multe tipuri de excepţii. Dintre toate clauzele except va fi executată cel mult una. Instrucţiunile unei 
clauze except, tratează numai excepţiile generate în blocul t ry căruia clauza îi este asociată, nu şi excepţiile ce 
pot apare în alte clauze except. Clauza din exemplul următor poate trata mai multe tipuri de excepţii desemnate 
printr-o lista inchisă între paranteze : 


except (RuntimeError, TypeError, NameError): 
pass 


Ultima clauză except poate fi folosită fără a se specifica ce anume excepţie tratează, în acest caz această clauză 
tratează toate excepţiile netratate de celelalte clauze. Puteţi folosi această ultimă precauţie, şi este indicat să o 
faceţi, pentru a ascunde toate erorile ce pot apărea şi pe care nu le-aţi anticipat. O puteţi de asemenea folosi pentru 
a afişa un mesaj de eroare şi apoi a regenera excepţia, care va fi transmisă mai departe, urmând să fie eventual 
tratată de un alt bloc try: 
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import string, sys 
try: 

f 

s 

i 


open (’myfile.txt’ ) 
f.readline() 
int (string.strip(s)) 
except IOError, (errno, strerror): 
print "I/O error(%s): %s" % (errno, strerror) 
except ValueError: 


print "Nu poate fi convertit in integer" 
except: 

print "Eroare neasteptata:", sys.exc_info() [0] 

raise 


Instrucţiunile try dispun şi de o clauză opțională: else. Atunci când aceasta este folosită, ea trebuie să fie 
ultima dintre clauze. Instrucţiunile acestei clauze vor fi executate atunci când, blocul try nu generează nici o 
excepţie. Iată un exemplu: 


for arg in sys.argv[1:]: 

Leys 
f = open(arg, 'r') 

except IOError: 
print 'cannot open’, arg 

else: 
print arg, 'has', len(f.readlines()), 'lines” 
f.close() 


Utilizarea clauzei else este de preferat adăugării unor linii suplimentare de cod la sfârşitul blocului t ry, pentru 
că în acest fel se evită detectarea unei excepţii care nu a fost generată de instrucțiunile blocului try. 


O excepţie poate avea asociată şi o valoare, un argument al excepţiei. Prezenţa argumentului şi tipul acestuia 
depinde de tipul excepţiei. 

Clauza except poate accepta o variabilă după numele excepţiei, sau o listă de nume de excepţii. Variabila este legata 
de instanţa excepţiei, cu argumentele salvate în instance.args. Prin convenţie instanţa excepţiei defineşte _— 
_getitem__si__str__ si argumentele pot fi accesate, sau listate, direct, făra a mai referi . args. 


>>> try: 


raise Exception ('spam', ‘eggs’ ) 
except Exception, inst: 

print type (inst) 

print inst.args 

print inst 

x, y = inst 

print ’x =’, x 

print 'y =', y 


instanta exceptiei 
argumentele stocate in .args 
_ str__ permite args sa fie listate direct 


+ 
+ 
+ 
+ _ getitem_ permite args sa fie despachetate direct 


<type ’instance’> 
(" spam”, 'eggs’) 
(" spam”, 'eggs'”) 
x = spam 

y eggs 


Dacă o excepţie are un argument, acesta va fi afişat în ultima parte ("detaliu") a mesajului de excepţie netratată. 
Intr-un bloc try nu sunt tratate numai excepţiile generate imediat în cadrul blocului, ci şi dacă acestea apar în 
funcţiilor apelate (chiar şi indirect) in bloc. De exemplu: 
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>>> def this_fails(): 
x = 1/0 

>>> try: 
this_fails() 


except ZeroDivisionError, detail: 
print ‘Handling run-time error:’, detail 


Handling run-time error: integer division or modulo 


8.4 Generarea excepțiilor 
Instrucţiunea raise îi permite programatorului să genereze o anumită excepţie : 


>>> raise NameError, ’HiThere’ 
Traceback (most recent call last): 

File "<stdin>", line 1, in ? 
NameError: HiThere 


Primul parametru reprezintă tipul excepţiei, iar al doilea este optional şi reprezintă un eventual argument. 


Dacă se vrea să se stie când o excepţie a fost semnalată, dar nu se intenţionează tratarea ei, o formă mai simplifi- 
cataă a instrucţiunii rai se permite reaparitia excepţiei : 


>>> try: 
raise NameError, 'HiThere' 


except NameError: 
print 'An exception flew by!’ 
raise 


An exception flew by! 

Traceback (most recent call last): 
File "<stdin>", line 2, in ? 

NameError: HiThere 


8.5 Exceptii definite de utilizator 


Un programator îşi poate crea propriile excepţii prin creare unei clase de excepţii noi. În mod obişnuit excepţiile 
pot fi derivate din clasa Exception atât în mod direct cât şi indirect. De exemplu : 
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>>> class MyError (Exception): 
def __init_ (self, value): 
self.value = value 
def __str_ (self): 
return ‘self.value* 
>>> try: 
raise MyError (2x2) 


except MyError, e: 
print 'My exception occurred, value:’, e.value 


My exception occurred, value: 4 
>>> raise MyError, ‘oops!’ 
Traceback (most recent call last): 

File "<stdin>", line 1, in ? 
_main_ _.MyError: ‘’oops!’ 


Clasele de excepţii pot fi proiectate ca oricare alta clasă, dar in mod uzual ele sunt simple, deseori oferind numai 
un număr de atribute, ce permit să informeze asupra erorii ce a fost tratată. Când se implementează un modul, care 
poate genera un număr distinct de erori, se obişnuieşte să se creeze o clasa de bază a excepțiilor definite de acest 
modul şi subclase care să creeze clase specifice pentru diferite condiţii de eroare : 


class Error (Exception): 
"""Base class for exceptions in this module.""" 
pass 


class InputError (Error): 


"""Excetie generata pentru eroare de intrare. 


Atribute: 
expression -- expresia de intrare in care apare eroarea 


message -- explicarea erorii 
"uv 


def init (self, expression, message): 
self.expression = expression 
self.message = message 


class TransitionError (Error): 
"""Generata Cand o operatie asteapta o modificare 
de stare Care nu este permisa 


Attributes: 
previous -- starea la inceputul tranzitiei 
next -- noua stare Care este de asteptat sa apara 
message -- explicatie privind imposibilitatea tranzitiei 
wey 
def __init__(self, previous, next, message): 
self.previous = previous 


self.next = next 
self.message = message 


Multe excepţii sunt definite cu nume care se termina în “Error,” similar cu denumirea excepțiilor standard. 


Multe module îşi definesc propriile excepţii pentru a raporta erorile ce pot apărea în funcţiile definite de ele. Mai 
multe informaţii despre clase veţi găsi în capitolul dedicat acestora. 
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8.6 Definirea acţiunilor de curăţare 


Instrucţiunea try poate avea şi o altă clauză prin care se pot defini acţiuni de curăţare care vor fi executate în 
orice circumstanta. De exemplu: 


>>> try: 
raise KeyboardInterrupt 
finally: 
print 'Goodbye, world!’ 


Goodbye, world! 

Traceback (most recent call last): 
File "<stdin>", line 2, in ? 

KeyboardInterrupt 


Clauza finally este executată dacă a fost sau nu generată o excepţie în blocul try. Când apare o excepţie, aceasta 
este regenerată după ce sunt executate instrucţiunile clauzei finally. Clauza finally este de asemenea 
executată “la ieşire”, chiar şi atunci când a fost apelată o instrucţiune break sau return. 


Codul scris în clauza finally este util pentru eliberarea resurselor externe (cum ar fi fişiere sau conectări la 
reţea), fara a mai vedea daca utilizarea resurse s-a încheiat cu succes. 


O instrucţiune t ry trebuie fie să aibe una sau mai multe clauze except, fie o clauză finally, dar nu ambele 
în acelaşi timp. 
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CAPITOLUL 
NOUĂ 


Clase 


Mecanismul de clase al limbajului Python face posibilă adăugarea de noi clase cu un minim de efort. Acest 
mecanism de clase este o combinaţie între mecanismele din C++ şi Modula-3. La fel ca şi pentru module, Python 
nu creează o barieră absolută între definiţie şi utilizator, ci se bazează mai mult pe “politetea” utilizatorului de a 
nu “pătrunde în definiție”. Cele mai importante facilităţi ale claselor sunt în continuare disponibile : mecanismul 
de moştenire permite clase de bază multiple, o clasă derivată poate suprascrie orice metodă a clasei/claselor de 
bază, o metodă poate poate apela o metodă a clasei de bază cu acelaşi nume. Obiectele au un număr arbitrar de 
date private. 


În terminologie C++, toate componentele unei clase (inclusiv datele membre) sunt publice, şi toate funcţiile mem- 
bre sunt virtuale. Nu există constructori sau destructori specializaţi. La fel ca în Modula-3, nu există scurtături 
pentru a accesa membrii unui obiect din cadrul unei metode a acelui obiect: metodele sunt declarate cu un prim 
argument explicit reprezentând obiectul, care este apoi transmis automat în momentul apelarii. Ca şi în Smalltalk 
clasele insăle sunt în sine obiecte ; în sens mai larg: în Python toate tipurile de date sunt obiecte. Astfel sunt 
posibile importurile şi redenumirile. Spre deosebire de C++ şi Modula-3, tipurile predefinite pot fi utilizate drept 
clase de bază de către utilizator. De asemenea, la fel ca în C++, dar spre deosebire de Modula-3, majoritatea 
operatorilor cu sintaxă specială (de exemplu: operatorii aritmetici) pot fi redefiniti în instantierile claselor. 


9.1 Câteva cuvinte despre terminologie 


Deoarece nu există o terminologie unanim recunoscută în ceea ce priveşte clasele, vom folosi aici termenii din 
SmallTalk şi C++. Am putea folosi termenii din Modula-3, deoarece semantica acestui limbaj este mai aproape de 
cea a Python-ului, dar foarte puţini utilizatori au auzit de acest limbaj, deci C++ şi SmallTalk sunt o alegere mult 
mai bună, fiind limbaje cu o popularitate mult mai mare. 


Va trebui de asemenea să avertizăm cititorii asupra unei capcane de terminologie : cuvântul : în Python cuvăntul 
“obiect” nu înseamnă obligatoriu o instantiere a unei clase. Ca şi în C++ şi Modula-3, dar nu şi ca în SmallTalk, 
în Python unele tipuri de date nu sunt neapărat clase: numerele întregi şi listele, dar şi alte tipuri de date mai 
“exotice”, ca fişierele nu sunt clase. Toate tipurile de date din Python au, semantic, ceva comun, care este mai uşor 
de explicat dacă ne referim la ele folosind cuvântul “obiect”. 


Obiectele pot avea individualitate, sau pot avea mai multe nume(care pot servi mai multor scopuri) care să de- 
semneze acelaşi obiect. Aceast procedeu se numeşte, în alte limbaje, “aliasing”. De obicei, in Python, la prima 
vedere, nu sunt încurajate astfel de tehnici, care pot fi foarte bine ignorate când este vorba despre tipurile de date 
nemodificabile(numere, şiruri, perechi). În orice caz aliasing are şi un efect (intenţionat) asupra sintaxei Python 
care priveşte obiectele alterabile (liste, dicţionare, etc.) şi obiectele ce există în afara contextului în care se află 
programul (fişiere, ferestre. etc.). Puteţi utiliza tehnica aliasing, pentru a beneficia de puterea oferită în alte lim- 
baje, de pointeri, întrucât puteţi considera că alias-urile funcţionează, într-un anumit sens, ca pointerii din C. Spre 
exemplu transmiterea unui obiect este mai simplă, din moment ce se transmite doar un pointer. Dacă o funcţie 
primeşte ca parametru un obiect, pe care îl modifică, apelantul va putea observa modificările făcute asupra obiec- 
tului şi nu asupra reprezentării locale. Acestea elimina necesitatea folosirii a două mecanisme de transmitere a 
parametrilor, ca în Pascal. 
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9.2 Domenii de vizibilitate (Scopes) şi domenii de definiţie a nu- 
melor(Name Spaces) 


Definiţiile claselor manipulează într-un mod foarte interesant domeniile de definiţie a numelor, şi o foarte bună 
înţelegere a modului de funcţionare a domeniilor de vizibilitate şi de definiţie a numelor este foarte impotantă. 


Înțelegerea acestor mecanisme este foarte importantă si se va dovedi foarte utilă oricărui programator avansat 
Python. 


Să începem cu câteva definiţii. 


Un domeniu de definiţii a numelor este o “hartă” de legături între nume şi obiecte. În momentul de faţă aceste 
domenii sunt implementate folosind dicţionare, dar metodele de implementare pot fi schimbate pe viitor. Exemple 
de astfel de domenii sunt: domeniul numelor predefinite, domeniul numelor globale dintr-un modul, domeniul 
numelor locale creat la apelarea unei funtii, etc. Într-un anumit sens atributele unui anume obiect formează un 
domeniu de definiţie. Un lucru foarte important de ştiut este acela că între două nume existente în două domenii 
diferite nu există absolut nici o legătură. Din această cauză două module pot defini o funcţie cu aceeaşi denumire 
fără a se crea confuzie. 


Un atribut este orice nume care urmează unui punct, de exemplu în expresia z.real, real este un atribut al 
obiectului z. Într-un sens strict, referintele la numele definite într-un modul sunt de fapt referinţe la atribute ale 
modulului: în expresia modul . funcţie, modul este modulul iar funcție este un atribut al modulului. 


Numele globale ale modulului şi atributele modulului se află în acelaşi domeniu de definiţie al numelor.(Există o 
singură excepţie. Modulele au un atribut nemodificabil (read-only) “secret”: __dict__, în care se află domeniul 
de definiţie al numelor ce aparţine modulului. __dict___ este un atribut dar nu este un nume global.) 


Atributele pot fi nemodificabile(read-only) sau modificabile(writeable). Atributele unui modul sunt modificabile: 
se poate folosi o secvenţă de genul: “modul . răspuns = 42’. Atributele modificabile pot fi de asemenea şterse 
folosind operatorul del. De exemplu ‘del modul.răspuns” va elimina atributul răspuns din obiectul 
denumit modul. 


Domeniile de definiţie a numelor sunt create la momente de timp diferite şi au perioade de viaţă diferite. Domeniul 
care conţine numele predefinite este creat odată cu pornirea interpretorului Python şi nu este şters niciodată. 
Domeniul numelor globale definite într-un modul este creat atunci când este încărcată definiţia modulului şi este 
distrus, de obicei, tot în momentul în care interpretorul este închis. Instrucţiunile executate la primul nivel al 
interpretorului fie dintr-un script, fie interactiv, fac parte dintr-un modul numit __main__. Numele predefinite 
se află în domeniul — builtin__. 


Domeniul de definiţie a numelor pentru o funcţie este creat odată cu apelul funcţiei şi este şters odată cu ter- 
minarea funcţiei, fie prin return, fie dacă acesta generează o excepţie netratată. Bineînţeles că apeluri recursive 
generează mai multe domenii de definiţie. 


Un domeniu de vizibilitate este o regiune a unui program Python în care un anumit domeniu de definiţie a numelor 
este accesibil. Accesibil înseamnă că o anumită referinţă la un nume va genera o căutare în domeniul de definiţie 
al acelui modul, despre care spunem că este accesibil. 


Domeniile de vizibilitate sunt determinate static si sunt folosite dinamic. În timpul execuţiei există exact trei 
domenii de vizibilitate (exact trei domenii de definiţie sunt direct accesibile): primul, “cel mai adânc”, conţine 
numele locale, cel de-al doilea conţine numele globale ale modulului curent, iar cel de-al treilea, “cel mai de sus”, 
care este şi ultimul în care se caută un nume, dacă în celelalte căutarea nu a avut succes. Cel de al treilea nivel 
conţine numele predefinite. 


De obicei, “cel mai adânc” domeniu de vizibilitate este cel al funcţiei care este executată. In exteriorul unei funcţii, 
acest domeniu este identic cu al doilea domeniu (cel din mijloc), în care se află accesibile definițiile modulului. 


Domeniul de vizibilitate global al unei funcţii definite într-un modul este domeniul de definiţii al respectivului 
modul, indiferent de unde, sau cu ce alias este apelată respectiva funcţie. Pe de altă parte căutarea unui anumit 
nume este realizată dinamic, în timpul execuţiei. Cu toate astea definiţia limbajului evoluează către o “rezolutie” 
a numelor statică, în timpul compilării. În concluzie nu vă bazati prea tare pe varianta dinamică. Deja variabilele 
locale sunt determinate static. 


O caracteristică a limbajului Python este aceea că atribuirile au loc în primul domeniu de vizibilitate(“cel mai de 


58 Capitolul 9. Clase 


jos” sau “cel mai adânc”)!. Atribuirile nu realizează o copiere a datelor, ci leagă nume de obiecte. Acest lucru 
este valabil şi pentru ştergeri. Instrucţiunea del x şterge legătura lui x din domeniul local de definiţie. De fapt 
toate operatiinile care introduc nume noi au impact asupra domeniului de definiţii local: instrucţiunile import, 
sau definiţia unei funcţii, introduc numele modulului importat, respectiv numele funcţiei, în domeniul de definiţii 
local. Dacă este folosită instructuinea global se indică intrepretorului ca următorul nume să fie introdus in 
domeniul global. 


9.3 Oprima privire asupra claselor 


Noţiunea de clasă aduce cu sine şi câteva alte noţiuni noi de sintaxă, trei tipuri noi de obiecte, şi câteva noţiuni noi 
de semantică. 


9.3.1 Sintaxa de definire a unei clase 


Cea mai simplă definiţie a unei clase arată astfel: 


class ClassName: 
<statement-1> 


<statement-N> 


Definiţiile de clase, la fel ca definițiile de funcţii, sunt valabile de abia după ce sunt executate. Puteţi insera o 
definiţie de clasă în cadrul unei instrucţiuni if, şi clasa nu va exista decât dacă condiţia instrucţiunii if va fi 
adevărată. 


În practică, instrucţiunile din interiorul unei clase vor fi definiţii de funcţii, dar sunt permise şi alte instructuni care 
pot fi uneori foarte utile. Definiţiile de funcţii din cadrul unei clase sunt un pic deosebite faţă de ce cunoaşteţi până 
acum, dar despre asta vom vorbi mai târziu. 


Atunci când este introdusă definiţia unei clase noi, un nou domeniu de definiţii a numelor este creat şi folosit ca 
domeniu de vizibilitate local, deci toate atribuirile vor afecta noul domeniu de definiţii creat. Definiţiile de funcţii 
vor introduce numele acelor funcţii tot în acest domeniu. 


Când definiţia unei clase se termină normal, fără erori, este creat un obiect nou de tipul class. Pe scurt, acest 
obiect “conţine” noul domeniu de definiţii creat odată cu definiţia clasei. În următoarea secţiune vom discuta mai 
mult despre obiectele de tip class. Domeniul de vizibilitate existent înaintea definiţiei clasei este reactivat, şi 
obiectul class este introdus în respectivul domeniu de definiţii sub numele dat de numele specificat în definiţia 
clasei (în exemplul de mai sus: ClassName). 


9.3.2 Obiecte clasă (class) 


Această categorie de obiecte acceptă două categorii de operaţii: referentieri de atribute şi instantieri. 


Referentierile de atribute folosesc sintaxa standard din Python: obiect .atribut. Atribute valide sunt toate 
numele existente în domeniul de definiţii în momentul creării obiectului class. Aşa că, dacă definiţia clasei arată 
astfel: 


class MyClass: 
"Un exemplu simplu de clasa" 
i = 12345 
def f(self): 
return "hello world’ 


| N.T. termenul original este innermost 
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atunci MyClass.i şi MyClass.f sunt referinţe la atribute valabile. Unul dintre atribute este un întreg (i), 
iar celălalt o metodă(f). Se pot realiza atribuiri cu atributele unei clase, deci puteţi modifica valoarea atributului 
MyClass . i printr-o atribuire. __doc__ este de asemenea un atribut al clasei, care are valoarea : “Un exemplu 
simplu de clasa”. 


Instanţierea claselor foloseşte notația de la funcţii. Putem să ne imaginăm că obiectul clasă este o funcţie fara 
parametrii care întoarce, ca rezultat, o nouă instanţă pentru respectiva clasă. Exemplul următor: 


x = MyClass() 


crează o nouă instanţă a clasei şi atribuie acest obiect variabilei locale x. 


Operația de instantiere crează un obiect vid. Multe clase preferă să creeze un obiect într-o stare iniţială. Pentru a 
realiza acest lucru clasa trebuie să aibă definită o metodă specială, numită __init___(), ca în exemplul de mai 
jos: 


def __init__(self): 
self.data = [] 


Atunci când o clasă are definită metoda__init__ (), la instantierea ei se apelează automat metoda__init_- 
__ 0). In acest fel se obţine o instanţă inifializatá a clasei : 


x = MyClass() 


Metoda __init___() poate avea şi argumente. În acest caz argumentele primite la instantierea clasei sunt 
transmise automat metodei __init___(). De exemplu: 


>>> class Complex: 
def __init__ (self, realpart, imagpart): 
self.r = realpart 
self.i = imagpart 


>>> x = Complex( 3.0, -4.5) 
>>> x.r, X.i 
(3, 0, 4.5) 


Vă puteţi gândi la metoda __init___() cala un constructor, deşi nu este un constructor în toată puterea cuván- 
tului. 


9.3.3 Obiecte instantiate 


Ce putem face cu instanţele? Singurele operaţiuni acceptate sunt operaţiunile cu atribute. Există două tipuri de 
nume de atribute valide : proprietăţi şi metode. 


Prima categorie sunt propietdtile, sau atribute de tip dată. Această categorie corespunde “variabilelor instanţei” în 


SmallTalk, şi “membrilor dată” în C++, create automat atunci când le sunt atribuite valori. Dacă x este o instanţă 
a clasei MyClass următoarea porţiune de cod va afişa valoarea 16: 


x.counter = 1 
while x.counter < 10: 
x.counter = x.counter * 2 


print x.counter 
del x.counter 


A doua categorie sunt metodele. O metodă este o funcţie ce aparține unui anumit obiect.(În Python termenul de 
metodă nu desemnează doar o funcţie ce aparţine numai instanţei unei clase, adică unui obiect clasă; şi alte tipuri 
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de obiecte au metode. De exemplu, obiectele listă au metodele: append, insert, sort, etc. În cele ce urmează 
vom folosi termenul de metodă numai în sensul mai sus definit). 


Numele de metode disponibile pentru un anumit obiect depind de clasa din care face parte obiectul. Prin definiţie 
toate atributele de tip funcţie ale unei clase devin metode pentru toate instanţele respectivei clase. În exemplul 
nostru x. f este o metodă valabilă din moment ce MyClass. f este o funcţie. In mod contrar este evident că 
x.i nu este o metodă, pentru că MyClass.i nu este o funcţie. Există o diferenţă între MyClass.f şi x. f: 
MyClass.f este un obiect funcţie iar x.f este un obiect metodă (una este funcţie, a doua metodă). 


9.3.4 Obiecte metodă 


În mod uzual o metodă este apelată imediat: 


x.f() 


In exemplul nostru aceasta va returna sirul de caractere Hello World!. Oricum nu este neapárat necesar sá 
apelám o metodá. Putem face acest lucru mai tárziu: 


xf = x.f 
while 1: 
print xf() 


Exemplul de mai sus va afişa Hello World! la infinit. 


Ce se întâmplă exact atunci când este apelată o metodă? Aţi observat că x.f () a fost apelată fără nici un 
argument, chiar dacă în definiţia funcţiei, din corpul clasei, era specificat un argument. 


Ce s-a întâmplat cu argumentul ? Cu siguranţă Python generează o excepţie atunci când o funcţie care necesită un 
argument este apelată fără el, deşi s-ar putea nici să nu fie utilizat. 


Probabil că aţi ghicit deja răspunsul: metodele au întotdeauna ca prim parametru un obiect.În exemplul nostru 
apelul x. f£ () este absolut echivalent cu MyClass.f (x). În general a apela o metodă cu n parametrii este 
echivalent cu a apela funcţia corespondentă inserând la începutul listei de n argumente obiectul a cărui metodă se 
doreşte apelată. 


Dacă nu aţi înţeles încă cum funcţionează metodele, o privire asupra implementării probabil că ar clarifica lu- 
crurile. Atunci când se face o referire la un atribut, care nu este un atribut dată, al unei instanţe este căutat în clasa 
din care face parte. Dacă numele reprezintă un atribut existent în respectiva clasă (un obiect de tip funcţie), este 
creat un obiect metodă “împachetând” obiectul instanţă şi obiectul functie(tocmai găsit). În acest fel se creeaza 
un obiect metodă. Atunci când un obiect metodă este apelat cu o listă de argumente, el este despachetat din nou, 
o nouă listă de argumente este construită din obiectul instanţă şi lista de argumente originală. În cele din urmă 


obiectul funcţie este apelat cu noua listă de argumente. 


9.4 Alte observaţii 


Atributele de tip dată suprascriu atributele metodă cu acelaşi nume. Pentru a evita conflicte de nume, ce pot cauza 
erori greu de găsit în programe mari, este bine să folosiţi o convenţie pentru denumiri. O posibilă convenţie ar fi 
scrierea numelelor de metode cu literă iniţială mare, prefixarea numelor de atribute dată cu un şir de caractere mic 
şi unic, (poate fi un underscore), sau pentru metode folosiţi verbe, iar pentru propietati substantive. 


Atributele dată pot fi accesate de metode la fel de bine ca şi de utilizatorii unui anumit obiect. Cu alte cuvinte 
clasele nu pot fi folosite pentru a implementa tipuri de date abstracte. De fapt, în Python, nu există nici un fel de 
mecanism de ascundere a datelor - aceasta realizându-se numai prin convenţie. (Pe de altă parte, implementarea 
limbajului Python, relizată în C, poate ascunde complet detalii de implementare controlând accesul la datele unui 
obiect, dacă o astfel de abordare este necesară). 


Utilizatorii unui obiect ar trebui să manipuleze atributele dată (propietatile) cu atenţie - orice modificare directa a 
acestora putând duce la o “incoerentá” a obiectului respectiv. De notat este faptul că utilizatorii unui obiect, pot 
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adăuga propriile atribute dată fără a afecta în vreun fel metodele, atâta timp cât nu apar conflicte de nume(şi aici 
existenţa unei convenţii vă poate scuti de multe neplaceri). 


Nu există nici o scurtătură pentru referirea atributelor din interiorul unei metode. Acest lucru clarifică codul unei 
metode, nemaiexistând posibilitatea confuziei între variabilele locale şi variabilele instanţei. 


In mod conventional, primul argument al unei metode are numele: self. Aceasta este numai o convenţie, numele 
self neavând nici o semnificaţie specială în Python. Folosind această convenţie codul dumneavoastră va fi mai 
uşor de citit de către programatori. 


Orice obiect funcţie, ca atribut al unei clase, defineşte o metodă asociată pentru instanţele unei clase. Nu este 
neapărat necesar ca definiţia unei funcţii să se afle în cadrul definiţiei clasei. In acest sens se poate atribui un 
obiect funcţie unei variabile locale. De exemplu: 


+ Functie definita inafara clasei 


def fl(self, x, y): 
return min(x, x+ty) 


class C: 
f = fl 
def g(self): 
return “hello world’ 
h = 9 


Acum f,g, şi h sunt toate atribute ale clasei C, şi sunt atribute funcţiei, şi in mod consecvent sunt metode pentru 
toate instanţele clasei C. Această practică nu este indicată, întrucât nu face decât să încurce cititorul programului. 


Metodele pot apela alte metode utilizând metoda atributelor argumentului self : 


class Bag: 

def empty(self): 
self.data = [] 

def add(self, x): 
self.data.append (x) 

def addtwice(self, x): 
self.add (x) 
self.add (x) 


Metodele pot face referiri la nume globale în acelaşi mod ca funcţiile obişnuite. Domeniul global de vizibilitate 
asociat unei metode permite accesul la domeniul de definiţie a numelor asociat modulului în care se află definită 
clasa căreia îi aparţine metoda. 


Clasa în sine nu este folosită niciodată ca un domeniu global de vizibilitate. Pot fi găsite multe utilizări ale 
domeniului global de vizibilitate, deşi unii ar putea considera inutilă existenţa acestuia. 


9.5 Mostenirea 


Nu putem spune despre un limbaj cá este orientat pe obiect, dacá sistemul de clase nu pune la dispozitie mecan- 
ismul de moştenire. Sintaxa pentru moştenire (adică pentru crearea definiţiei unei clase derivate dintr-o clasă de 
bază) este următoarea: 
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class DerivedClassName (BaseClassName) : 
<statement-1> 


<statement-N> 


Clasa BaseClassName trebuie să fie definită pentru ca definiţia clasei derivate să fie corectă. În loc de un nume 
de clasă puteţi folosi o expresie, acest lucru fiind foarte util atunci când clasa de bază se află într-un alt modul: 


class DerivedClassName (modname.BaseClassName) : 


Atunci când obiectul class pentru clasa derivată, este creat, este memorată şi clasa de bază. Acest mecanism 
este folosit pentru a rezolva referirile la atribute: în caz că un atribut nu este găsit în clasa derivată, este căutat şi 
în clasa de bază. Regula se aplică recursiv dacă clasa de bază este la rândul ei o clasă derivată. 


Instanţierea unei clase se face la fel ca până acum. Dacă este apelată o metodă a unei instante, numele metodei 
este căutat întâi în definiţia clasei derivate, apoi în definiţia clasei de bază, şi aşa mai departe până când este găsit 
un obiect funcţie corespunzător în lanţul de moşteniri. 


Clasele derivate pot suprascrie metode ale clasei de bază. Deoarece o metodă nu dispune de nici un privilegiu 
atunci când apelează o altă metodă a aceluiaşi obiect, o metodă a clasei de bază care apelează o altă metodă, 
definită de asemenea în clasa de bază, poate să apeleze de fapt o metodă suprascrisă de clasa derivată (pentru 
programatorii C++ putem spune că toate metodele din Python sunt virtuale). 


O astfel de metodă suprascrisă poate chiar să extindă metoda de bază, în loc de a o înlocui. Există o cale simplă 
de a apela direct o metodă a clasei de bază : ClasádeBazá.metodá (self.argumente). 


Acest lucru poate fi foarte util chiar şi utilizatorilor(clientilor) unei clase. 


9.5.1 Mostenirea multiplă 


Python pune la dispoziţia programatorilor şi o formă de moştenire multiplă. O definiţie de clasă derivată din mai 
multe clase de bază arată în felul următor: 


class DerivedClassName (Basel, Base2, Base3): 
<statement-1> 


<statement-N> 


Regula dupá care sunt cáutate atributele este urmátoarea: dacá un atribut nu este definit ín clasa derivatá atunci 
acesta este căutat în definiţia clasei Basel si în toate clasele de la care aceasta moşteneşte, apoi este căutat în 
Base? şi în Base3 după aceleaşi reguli. Putem rezuma această regulă în felul următor: “întâi în adâncime, şi 
de la stânga la dreapta”. (Avantajele şi dezavantajele acestei reguli pot fi discutate, însă trebuie să fie foarte clar 
pentru toată lumea că o astfel de regulă este absolut necesară, fapt suficient de evident). 


Este suficient de clar că folosirea mecanismului de moştenire multiplă va crea mari probleme de întreţinere, 
deoarece în Python conflictele ce pot apărea între nume sunt evitate numai prin convenţii. O problemă cunos- 
cută apare atunci când o clasă moşteneşte de la două clase care la rândul lor sunt derivate dintr-o singură clasă. 
Deşi este destul de simplu să ne imaginăm ce se va întâmpla în acest caz, nu este clar că regulile vor fi de folos 
pentru clarificarea situaţiei. 
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9.6 Variabile private 


Există un suport limitat pentru identificatorii clselor private. Orice identificator de forma __spam (cel putin 
două underscore înainte, cel mult un underscore după) este acum textual înlocuit cu _clasá__ spam, unde 
clasă este numele curent al clasei cu underscor-urile din faţă suprimate. Mutilarea este realizată fara o analiza 
a poziţiei sintactice a identificatorului, aşa încăt putând fi folosită la definirea unei instantieri a unei clase private 
şi a variabilelor şi metodelor clasei ca globale, şi la memorarea instantierii variabilelor private înaceastă clasă la 
instantierea altei clase. O trunchere a numelui poate apărea când acesta este mai lung de 255 de caractere. În 
afara claselor, sau când numele clasei este alcătuit numai din underscor-uri, nu se face eliminarea underscor-urilor. 


Acest mecanism pune la dispoziţia programatorului o metodă foarte facilă de a crea atribute private, fără a-şi face 
griji că aceste atribute pot provoca conflicte de nume. Toate acestea sunt realizate în Python pentru a preveni 
eventualele erori, totuşi, este în continuare posibilă modificarea atributelor private, ceea ce se poate dovedi foarte 
util în anumite cazuri ca de exemplu la depanare. ( Observatie : o clasă derivată care are acelaşi nume cu clasa de 
bază poate folosi variabilele private ale clasei de bază). 


Observati cum codul ce este trimis instrucţiunilor exec, eval () sau evalfile () nu ia în considerare nu- 
mele clasei care realizează invocările, acest efect fiind similar celui realizat prin instrucţiuni global, efect ce 
nu poate fi obținut pentru cod compilat. Aceeaşi restricţie se aplică şi pentru getattr(), setattr() şi 
delattr (), de asemenea şi pentru accesarea directă a dicționarului __dict__. 


Iată un exemplu de clase care implementează propriile metode __getattr__() şi __setattr__(), şi 
stochează toate datele în variabile private: 


class VirtualAttributes: 
__vdict = None 
__vdict_name = locals().keys() [0] 


def __init__ (self): 
self.__dict__[self.__vdict_name] = {} 


def __getattr__(self, name): 
return self.__vdict [name] 


def __setattr__ (self, name, value): 
self.__vdict [name] = value 


9.7 Altfel de clase 


Câteodată, poate fi foarte util să putem crea tipuri de date similare celei record din Pascal, sau st ruct din C, 
tipuri de date care să adune la un loc mai multe date de diferite tipuri. Pentru a realiza acest lucru puteţi folosi 
clasele. O definire a unei clase vide se poate face astfel : 


class Employee: 
pass 


john = Employee() # Se creaza o inregistrare vida de tip employee 


# Fill the fields of the record 
john.name = “John Doe’ 
john.dept = 'computer lab’ 
john.salary = 1000 


Să construim un alt scenariu: presupunând că aveţi o funcţie care prelucrează anumite date dintr-un obiect fişier, 
puteţi sá definiti o clasă cu metodele read () şi readline () care sá citescă informaţii dintr-un şir de caractere 
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în loc de un fişier. 


Metodele obiectelor au, de asemenea, atribute: metodă.im__self reprezintă obiectul de care aparţine metoda 
specificată, iar metodă. im__ func reprezintă funcţia corespunzătoare metodei. 


9.8 Exceptiile pot fi clase 


Exceptiile definite de utilizator pot fi atat obiecte de tip string, cat si clase. Folosind clasele pentru a defini 
excepţii, puteţi crea o întreagă ierarhie de excepţii care poate fi foarte uşor extinsă. 


Există o altă formă a insructiunii raise: 


raise Class, instance 


raise instance 


In prima formă instance trebuie să fie o instanţă a clasei Class sau a unei clase derivate. A doua formă este 
o prescurtare pentru: 


raise instance.__class__, instance 


O clauză except poate afişa atât excepţii de tip clasă, cât şi de tip şir de caractere. Următorul exemplu va afişa 
B, C, D în această ordine: 


class B: 
pass 
class C(B): 
pass 
class D(C): 
pass 


for c in [By C, Dl]: 


try: 
raise c() 
except D: 
print "D" 
except C: 
print, MEN 
except B: 
print "B" 


De observat că dacă ordinea clauzelor except ar fi fost inversă, (cu except B la început), exemplul ar fi afişat 
B, B, B; deoarece clasa B este clasa din care sunt derivate clasele C şi D. 


Când un mesaj de eroare este afişat pentru o excepţie netratată ce provine dintr-o clasă, numele clasei este de 
asemenea afişat. 


9.9 lteratori 


Pâna acum aţi observat că majoritatea obiectelor container se pot baleia utilizând instrucţiunea for : 
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for 


for 


for 


for 


for 


eleme 
prin 
eleme 
prin 
key i 
prin 
char 
prin 
line 
prin 


nt an. [ls 2, 31% 

t element 

nt: in. (1, Zp 3) 

t element 

n {’one’:1, “two” :2): 
t key 

try DES 

t char 

in open("myfile.txt"): 
t line 


Acest mod de accesare este clar,concis şi comod. Folosirea iteratorilor este larg raspândită în proiectarea Python- 
ului. Prin modul său de implementare instructiunea for apelează iter () pentru obiectul container. Funcţia 
returnează un obiect iterator care defineşte metoda next () prin care se accesează doar o singură dată fiecare 
element al containerului. Când toate elementele au fost epuizate, next () setează excepţia StopIteration, 
care comunică buclei for să se oprească. Modul de funcţionare este ilustrat de următorul exemplu : 


abc’ 
iter(s) 


<iterator object at 0x00A1DB50> 


>>> s =! 
>>> it = 
>>> it 
>>> it.ne 
ra? 
>>> it.ne 
Ep? 
>>> it.ne 
rer 
>>> it.ne 
Traceback 
File "< 
it.ne 
Stopltera 


xt () 


xt () 


xt () 


xt () 
(most recent call last): 


pyshell#6>", line 1, in -toplevel- 


xt () 
tion 


S-a văzut mecanismul din spatele procesului de iterare.Este uşor de a implementa un comportament iterarativ 
claselor proiectate de către utilizator. Se defineşte o metodă __iter__ (). Această metodă returnează un obiect 
ce va avea o metodă next (). Dacă clasa defineşte next (), atunci__iter___() va returna doar self : 


class Reverse: 


"Iterator for looping over a sequence backwards" 


def __init (self, data): 


def 


def 


self.data = data 
self.index = len(data) 


__iter__ (self): 


return self 
next (self): 
if self.index == 

raise Stoplteration 
self.index = self.index 1 
return self.data[self.index] 


>>> for char in Reverse(’spam’): 


uov sg. 


P 


rint char 
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9.10 Generatori 


Generatorii sunt instrumente simple şi puternice pentru crearea iteratorilor. Generatorii se scriu ca şi functiile 
obişnuite, dar se utilizează instrucţiunea yield când se doreşte o returnare de date. De fiecare data se apelează 
next (), generatorul reluând din locul de întrerupere ( el memorează toate valorile datelor şi ce instrucţiune a 
fost executată ultima). Exemplul următor prezintă cât de simplu se poate crea un generator : 


def reverse (data): 
for index in range (len (data)-1, -1, -1): 
yield data[index] 
>>> for char in reverse(’golf’): 
print char 


Q OBRA.: 


Tot ce se poate face cu generatori se poate face şi cu clase bazate pe iteratori, descrise în secțiunea anterioară.Ce 
face ca generatorul să fie mai compact este faptul că metodele __iter ()___ şi next () sunt create automat. 


O altă caracteristică importantă este aceea că între apeluri sunt salvate variabilele locale şi starea execuţiei. Acest 
lucru face funcţia mai uşor de scris si mai clară decât abordarea cu variabile de clasă precum self.index şi 
self.data. 


În plus, la salvarea automată a variabilelor şi a stării programului, când generatorul îşi încheie lucrul, setează 
automat StopIteration.Toate aceste caracteristici dau posibilitatea de a scrie iteratori la fel de uşor ca şi o 
funcţie obişnuită. 


9.11 Expresii generator 


Unii generatori simpli se pot scrie succint ca expresii folosind o sintaxă similară cu cea a creării listelor obişnuite, 
dar cu paranteze în locul acoladelor.Aceste expresii sunt create pentru situaţiile in care generatorii sunt ceruti ca 
atare în corpul unei unei funcţii.Expresiile generator sunt mult mai compacte, dar şi mult mai putin cuprinzătoare 
decât definirea completă a generatorilor şi tind să fie mai uşor de memorat decât datele de tip listă. De exemplu : 


>>> sum(ixi for i in range(10)) + suma de patrate 
285 

>>> xvec = [10, 20, 30] 

>>> yvec = [7, 5, 3] 

>>> sum(x*y for x,y in zip(xvec, yvec) ) 

260 


>>> from math import pi, sin 

>>> sine_table = dict((x, sin(x*pi/180)) for x in range(0, 91)) 

>>> unique_words = set (word for line in page for word in line.split()) 
>>> valedictorian = max((student.gpa, student.name) for student in graduates) 
>>> data = ’golf’ 

>>> list (data[i] for i in range (len (data) -1,-1,-1)) 

PER d Cor. “er 
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10.1 Interfața cu sistemul de operare 
Modulul os conţine o serie de funcţii pentru interfatarea cu sistemul de operare : 


>>> import os 

>>> os.system(’time 0:02’) 

0 

>>> os.getcwd() # Returneaza directorul de lucru curent 
'c:\\Python24’ 

>>> os.chdir(’/server/accesslogs’ ) 


Asiguraţi—vă că folositi’ import os” inlocde’ from os import x’. Aceasta va împiedica os. open () 
să estompeze efectul funcţiei predefinite open (), care lucreaza într-un mod mult diferit. Fuctiile predefinite 
dir () şi help () sunt foarte utile ca un ajutor interactiv pentru lucrul cu module de dimensiuni mari, cum este 
cazul modulului os : 


>>> import os 

>>> dir (os) 

<returns a list of all module functions> 

>>> help (os) 

<returns an extensive manual page created from the module’s docstrings> 


Pentru administrarea fişierelor curente şi a directoarelor de lucru,modulul shut il furnizează o interfaţă de nivel 
înalt, uşor de folosit: 


>>> import shutil 
>>> shutil.copyfile(’data.db’, 'archive.db') 
>>> shutil.move (’/build/executables’, ‘'installdir’ ) 


10.2 Fisierele Wildcard (asterisc) 


Modulul glob oferă o funcţie pentru realizarea listei cu fişierele căutate într-un director folosind asterisc în locul 
numelui : 
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>>> import glob 
>>> glob.glob(’*.py’) 
[’primes.py’, 'random.py', ‘’quote.py’ ] 


10.3 Argumentele în linia de comandă 


Scripturil obişnuite reclamă adesea procesarea liniilor de comandă cu argumente. Aceste argumente sunt depozi- 
tate, sub formă de listă, în atributele argv al modulului sys. Spre exemplu, în urma execuţiei următoarei linii de 
comandă "Python demo.py one two three’ varezulta: 


>>> import sys 
>>> print sys.argv 
[’demo.py’, 'one', 'two”, ‘three’ ] 


Modulul get opt prelucrează sys.argv aplicâd regula functiei UNIX getopt (). O prelucrare mai puternică şi 
mai flexibilă a liniei de comandă este oferită de modulul optparse. 


10.4 Redirectarea semnalarii erorilor şi terminarea execuţiei progra- 
mului 


Modulul sys conţine şi atribute pentru stdin, stdout şi stderr. Cel din urmă este utilizat pentru generarea de 
avertismente şi mesaje de eroare, pentru a le face vizibile chiar şi când stdout este redirectat : 


>>> sys.stderr.write (Warning, log file not found starting a new one\n’) 
Warning, log file not found starting a new one 


Modalitatea cea mai directă de a încheia un scrip este aceea de a folosi’ sys.exit()’. 


10.5 Unificarea tratării şirurilor 


Modulul re oferă ca instrumente expresii standard pentru procesarea de nivel avansat a şirurilor. Pentru potriviri 
complexe si pentru lucrul cu şirurile, sunt puse la dispoziţia utilizatorului expresii care oferă soluţii optimizate şi 
rapide : 


>>> import re 

>>> re.findall(r’\bf[a-z]*’, “which foot or hand fell fastest’) 
[’foot’, ‘fell’, 'fastest'] 

>>> re.sub(r’ (\b[a-z]+) \1’, r’\1’, ‘cat in the the hat’) 

“cat in the hat’ 


Cand impuse doar capabilitati reduse, atunci este de preferat lucrul cu metodele specifice sirurilor, pentru ca sunt 
uşor de citit şi de depanat : 


>>> 'tea for too’.replace(’too’, 'two') 
"tea for two’ 
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10.6 Module matematice 


Modulul math oferă acces la funcţiile din structura bibliotecii C pentru calculul în virgulă mobilă : 


>>> import math 

>>> math.cos(math.pi / 4.0) 
0.70710678118654757 

>>> math.log(1024, 2) 

10.0 


Modulul random are unelte pentru a face selectii aleatorii : 


>>> import random 

>>> random.choice([’apple’, 'pear', ‘banana’ ]) 

‘apple’ 

>>> random.sample (xrange (100), 10) + exemplificare fara inlocuire 

[30, 83, 16, 4, 8, 81, 41, 50, 18, 33] 

>>> random.random () + flotant obtinut aleatoriu 

0.17970987693706186 

>>> random. randrange (6) + intreg aleatoriu obtinut cu range(6) 
4 


10.7 Accesul la Internet 


Sunt o mulţime de module pentru accesarea internetului şi pentru procesarea protocoalelor de Internet. Două dintre 
cele mai simple sunt ur11ib2, pentru obţinerea datelor de la url-uri, şi smtplib, pentru trimiterea mesajelor 
prin poştă electronică : 

>>> import urllib2 


>>> for line in urllib2.urlopen(’http://tycho.usno.navy.mil/cgi-bin/timer.pl’): 
if ‘EST’ in line: + look for Eastern Standard Time 


print line 


<BR>Nov. 25, 09:43:32 PM EST 


>>> import smtplib 

>>> server = smtplib.SMTP(’ localhost') 

>>> server.sendmail (' soothsayer@example.org’, 'jcaesarlexample.org', 
"""To: jcaesarflexample.org 

From: soothsayer@example.org 


Beware the Ides of March. 


we ") 


>>> server.quit () 


10.8 Data si timpul 


Modulul dat et ime furnizează clase pentru prelucrarea datei şi a timpului atât într-o manieră simplistă, cât şi intr- 
una mai elaborată. Modulul implementează si aritmetica datei şi a timpului. O atenţie deosebită se acordă accesării 
eficiente a membrilor, pentru formatarea lor la afişare şi pentru prelucrare. De asemenea sunt implementate şi 
obiecte care sunt legate de ora locală. 
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+ datele sunt usor de construit si formatat 

>>> from datetime import date 

>>> now = date.today () 

>>> now 

datetime.date (2003, 12, 2) 

>>> now.strftime("Sm-Sd-Sy. Sd tb SY is a SA on the %d day of %B.") 
"12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.’ 


# datele suporta artmetica de tip calendar 
>>> birthday = date(1964, 7, 31) 

>>> age = now - birthday 

>>> age.days 

14368 


10.9 Compresarea datelor 


Formatele de arhivăre şi compresare obişnuite sunt accesate direct prin includerea modululelor zlib, gzip, 
bz2, zipfilesitarfile. 


>>> import zlib 


>>> s = 'witch which has which witches wrist watch’ 
>>> len(s) 

41 

>>> t = zlib.compress (s) 

>>> len(t) 

37 


>>> zlib.decompress (t) 

“witch which has which witches wrist watch’ 
>>> zlib.crc32(t) 

-1438085031 


10.10 Măsurarea performanţei 


Unii utilizatoru Python sunt interesaţi de cunoaşterea diferenţelor de performanţă între diferite abordări ale 
aceleiaşi probleme.Python ofera instrumente de măsură, care răspunde rapid cererilor. 


Exista tentatia foloseriii impachetării şi a despachetării perechilor (tuple) in locul obişnuitei schimbări intre argu- 
mentelor. Modulul t imeit evidenţiază imediat un mic avantaj de performanţă: 


>>> from timeit import Timer 

>>> Timer ('t=a; a=b; b=t’, 'a=1; b=2’) .timeit () 
0.57535828626024577 

>>> Timer (’a,b = b,a’, 'a=1l; b=2’) .timeit () 
0.54962537085770791 


In contrast cu t imeit, care operează pe coduri de foarte mici dimensiuni, modulele profile si pstats au 
instrumente pentru identificarea sectinii de timp critic pentru aplicatii de mari dimensiuni. 
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10.11 Controlul calităţii programului 


O abordare a programării de performanţă este aceea când pentru fiecare funcţie se sciu, în faza de proiectare, teste 
ce vor fi rulate pe perioada întregului proces de dezvoltare a aplicaţiei. 


Modulul doctest ofera un instrument de scanare a unui modul si de verificare a bunei functionári a testului 
implantat in docstring-ul programului. Implantarea testului în docst ring este uşoară. În docstring se va inscrie 
o apelare a funcţie împreună cu rezultatul execuţiei. Această implementare oferă utilizatorului un exemplu de 
utilizare a funcţiei si permite modulului doctest să se verifice conformitatea codului cu descrierea din documentaţie 


def average (values): 
"""Computes the arithmetic mean of a list of numbers. 


>>> print average([20, 30, 70]) 
40.0 


return sum(values, 0.0) / len(values) 


import doctest 
doctest .testmod () + verificarea automata a testului din documentatia functiei 


Cu modulul unittest nu se lucrează mai uşor decât cu modulul doctest, dar el oferă posibilitatea scierii 
unui program intr-un fişier cu un set complet de teste. 


import unittest 


class TestStatisticalFunctions(unittest.TestCase): 


def test_average (self): 
self .assertEqual (average ([20, 30, 70]), 40.0) 
self .assertEqual (round (average ([1, 5, 7]), 1), 4.3) 
self.assertRaises(ZeroDivisionError, average, []) 
self.assertRaises(TypeError, average, 20, 30, 70) 


unittest.main() # Calling from the command line invokes all tests 


10.12 Python oferit "la cheie" 


Limbajul Python este un limbaj oferit "la cheie", lucru dovedit de complexitatea si robustetea intregii distributii. 
De exemplu : 


e Modulele xm1rpclib şi SimpleXMLRPCServer fac implementări de proceduri apelabile de la distanţă 
de către aproape orice aplicaţie. In ciuda numelui nu este necesară cunoaşterea sau utilizarea XML. 


e Pachetul email este o bibliotecă pentru prelucrarea mesajelor de email, incluzând şi mesajele tipice MIM 
şi RFC 2822. Spre deosebire de smpt lib şi poplib, care, de fapt, transmit şi recepționează mesajele, 
pachetul emai 1 oferă un set complet de instrumente necesare la constituirea şi decodarea structurilor com- 
lexe ale mesajelor (inclusiv ataşare de fişiere - attachments) şi pentru implementarea protocoalelor de codare 
Internet şi a headerelor. 


e Pachetele xml . dom şi xml . sax ofera un suport puternic pentru analizarea unui text scris XML, un format 
foarte răspândit. În acelaşi fel modulul csv suportă scrierea şi citirea într-un format de bază de date comun. 
Împreuna aceste module şi pachete simplifică într-un mod elegant schimbarea de date între aplicaţiile Python 
si alte instrumente. 
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e Internationalizarea este asigurată de un număr de module ce inglobează pachetele gettext, locale şi 
codecs. 
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CAPITOLUL 
UNSPREZECE 


Pe scurt despre Standard Library - 
partea II 


In partea a doua a scurtei prezentări a Standard Library sunt analizate modulele necesare unei programări profe- 
sionale. Aceste module apar arareori in scripturile mici. 


11.1 Formatarea datelor de ieşire 


Modulul repr furnizează o versiune a funcţiei repr () pentru afişarea prescurtată a unor containere de lungime 
mare : 


>>> import repr 
>>> repr.repr (set (’supercalifragilisticexpialidocious’ ) ) 
"set (['a7, COL, Cah, rar: DERD tgi; E piu 


Modulul pprint execută un control mai sofisticat, atât asupra listării obiectelor predefinite, cît şi a celor definite 
de utilizator, într-un mod care poate fi usor citit de utilizator. Cînd reprezentarea este mai lunga decât o linie, 
"pretty printer" forţează sfârşitul liniei şi face alinierea, pentru o mai mare claritate în afişarea structurii de date : 


>>> import pprint 
>>> t = [[[[’black’, 'cyan'], 'white”, [’green’, 'red']], [[’magenta’, 
'yello'],'blue']]] 


>>> pprint.pprint (t, width=30) 
[LL [’black’, ‘cyan’] 
‘white’ 
['green', 'red']], 
[[’magenta’, 'yellow'], 
“blue']]] 


Modulul textwrap formatează paragrafele textului pentru a se putea încadra într-o anumită dimensiune impusă 
de programator pentru fereastra de afişare a datelor : 
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>>> import textwrap 

>>> doc = """The wrap() method is just like fill() except that it returns 
a list of strings instead of one big string with newlines to separate 
the wrapped lines.""" 


>>> print textwrap.fill(doc, width=40) 
The wrap() method is just like fill() 
except that it returns a list of strings 
instead of one big string with newlines 
to separate the wrapped lines. 


Modulul locale accesează o bază de date cu formate de reprezentare specifice diferitelor zone culturale ale 
lumii.Prin gruparea formatelor specifice zonelor se pot afişa numerele având caractere specifice de separare a 
cifrelor, precum şi semnului monetar specific : 


>>> import locale 

>>> locale.setlocale(locale.LC_ALL, "English _United States.1252’) 

"English _United States.1252' 

>>> conv = locale.localeconv() + se incarca parametrii zonali 
>>> x = 1234567.8 

>>> locale.format ("%3d", x, grouping=True) 

11,234,567' 

>>> locale.format ("Ss$.x*f", (conv[’currency_symbol’], 

A conv[’int_frac_digits’], x), grouping=True) 

'$1,234,567.80' 


11.2 Sirurile şablon (Templating) 


Modulul st ring conţine o clasă Template flexibilă,cu o sintaxă simplificată, utilă în editare.Aceasta permite 
utilizatorului să-şi personalizeze aplicaţiile. 

Formatul foloseşte cuvinte şablon alcătuite dintr-un delimitator (caracterul $) urmat de un identificator recunoscut 
de Python (şir de caractere alfanumerice şi underscore). Încadrând şablonul între acolade se permite continuarea 
acestuia cu un şir de caractere alfanumerice, care să nu fie separate prin spaţii. Caracterul $ se reprezintă scriind 


$s: 


>>> from string import Template 

>>> t = Template(’S{village}folk send $$10 to Scause.’) 

>>> t.substitute(village=’Nottingham’, cause=’the ditch fund’) 
‘Nottinghamfolk send $10 to the ditch fund.’ 


Metoda substitute setează KeyError când un şablon nu este găsit într-un dicţionar, sau într-un argument de 
tip cuvint cheie. 

Pentru aplicatiile de tip email utilizatorul poate omite completarea unor date. De aceea se recomanda utilizare 
metodei safe_substitute, ea lasând nemodificat şablonul cu data curespunzatoare lipsă : 


>>> t = Template(’Return the $item to Sowner.’) 
>>> d = dict (item=’unladen swallow’ ) 

>>> t.substitute (d) 

Traceback (most recent call last): 


KeyError: “owner” 
>>> t.safe_substitute (d) 
“Return the unladen swallow to Sowner.’ 
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Pentru şirurile şablon utilizatorul poate alege un anumit delimitator.De exemplu se poate alege drept delimitator 
caracterul $ : 


>>> import time, os.path 
>>> photofiles = [’img_1074.jpg’, ’img_1076.jpg’, ’img_1077. jpg’ ] 
>>> class BatchRename (Template): 


delimiter = '$' 
>>> fmt = raw_input(’Enter rename style (%d-date %n-seqnum %f-format) : 
Enter rename style (%d-date %n-seqnum %f-format) : Ashley_%sn%f 
>>> t = BatchRename (fmt) 


>>> date = time.strftime(’ Sdsb%y’ ) 
>>> for i, filename in enumerate (photofiles): 


base, ext = os.path.splitext (filename) 
newname = t.substitute(d=date, n=i, f=ext) 
print ’%Ss --> %s” % (filename, newname) 


img_1074.jpg --> Ashley_0.jpg 
img_1076.jpg --> Ashley_1.jpg 
img_1077.jpg --> Ashley_2.jpg 


O altă aplicabilitate a şirurilor şablon se găseşte in prelucrarea datelor de ieşire scrise in diferite formate. Aceasta 
se realiză înlocuind şabloanele definite de utilizator pentru fisierele XML, rapoartele text, sau rapoartele web scrise 
în HTML. 


11.3 Lucrul cu reprezentări binare ale datelor 


Modulul struct are funcţiile pack () şi unpack () pentru lucrul cu formate de înregistrare binară a datelor 
cu lungime variabilă. Exemplul următor prezintă cum se pot căuta informaţii prin header-ul unui fişier ZIP (cu 
cod de impachetare "H" şi "L", reprezentând numere făra semn de doi, respectiv, patru octeți) : 


import struct 
data = open(’myfile.zip’, 'rb').read() 


start = 0 
for i in range(3): + prezinta primele 3 headere ale fisierului 
start += 14 
fields = struct.unpack(’LLLHH’, data[start:start+16]) 
crc32, comp_size, uncomp_size, filenamesize, extra_size = fields 
start += 16 
filename = data[start:start+filenamesize] 
start += filenamesize 
extra = data[start:start+extra_size] 
print filename, hex(crc32), comp size, uncomp_size 
start += extra_size + comp_size # sare la urmatorul header 


11.4 Multi-threading 


Threading este o tehnică prin care se realizează decuplarea procesele care nu sunt dependente secvential unul 
de celălalt. Această tehnică se poate folosi pentru îmbunătăţirea răspunsului aplicaţiilor care primesc date de 
la utilizator, atunci când alte procese rulează în background. Un astfel de caz este acela în care un proces de 
intrare/ieşire rulează în paralel cu un proces de calcul. 


Următorul program prezintă cum modulul de nivel înalt threading poate executa procese in background, în 
timp ce programul principal continuă să ruleze : 
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import threading, zipfile 


class AsyncZip(threading.Thread) : 


def __ init__(self, infile, outfile): 
threading.Thread.__init__ (self) 
self.infile = infile 


self.outfile = outfile 
def run(self): 
f = zipfile.ZipFile(self.outfile, 'w”, zipfile.ZIP_DEFLATED) 
f.write(self.infile) 
f.close() 
print 'Finished background zip of: ', self.infile 


background = AsyncZip(’mydata.txt’, 'myarchive.zip'”) 
background. start () 
print 'The main program continues to run in foreground.’ 


background. join () # Wait for the background task to finish 
print 'Main program waited until background was done.’ 


Principala provocare in proiectarea aplicatiilor multi-threading este aceea de a coordona thread-urile care 
partajează aceleaşi date, sau aceleaşi resurse. La sârşit, modulele thread generează un număr de primitive de 
sincronizare precum : variabile de blocare, de stare, indicatori de tip semafor. 


11.5  Conectivitatea (Logging) 


Modulul Logging oferă un sistem de conectare flexibil şi cu toate caracteristicile specifice unui astfel de sis- 
tem.Mesajele de conectare sunt transmise către un fişier, sau către sys . stderr : 


import logging 

logging.debug(’ Debugging information”) 

logging.info(’ Informational message’ ) 
logging.warning(’Warning:config file %s not found’, 'server.conf') 
logging.error(’Error occurred’ ) 

logging.critical(’Critical error -- shutting down’) 


Acestea transmit următoarele : 


WARNING: root :Warning:config file server.conf not found 
ERROR: root:Error occurred 
CRITICAL: root:Critical error -- shutting down 


Implicit mesajele cu informaţii si cele de depanare sunt suprimate şi ieşirea este directionata către stderr. Alte 
opţiuni de ieşire includ rutarea mesajelor prin email, datagrame, soket, sau server HTML. Folosind filtre noi se 
pot selecta diferite rute funcţie de prioritatea mesajului : DEBUG, INFO, WARNING,ERROR, CRITICAL. 


Sistemul de conectare (loggin) poate fi configurat direct de Python, dar poate fi şi preluat dintr-un fişier de config- 
urare editat de utilizator, pentru a particulariza conectarea fără a altera setarea mediului. 
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11.6 Legături slabe la memorie 


Pentru fiecare obiect, Python realizează o legătura a acestuia cu memorie.Legătura poate fi puternică (permanentă), 
sau slabă (de scurtă durată). Aceste legături sunt administrate în mod automat, prin contorizarea legăturilor 
obiectelor şi prin folosirea "cosului de gunoi" pentru eliminarea ciclurilor.Memoria este eliberată imediat ce ultima 
referire la ea a fost eliminată. 


Acest comportament funcţionează bine pentru majoritatea aplicaţiilor, dar uneori se doreşte să se urmărească 
obiectele doar atât timp cât sunt utilizate de altă aplicatie.Din păcate această urmărire produce o legătură perma- 
nentă la memorie.Modulul weackref oferă instrumente pentru urmărirea obiectelor prin crearea unor legături 
slabe. Când un biect nu mai este necesar va fi automat eliminat din tabela de legături slabe. 


>>> import weakref, gc 
>>> class A: 
def __init__ (self, value): 
self.value = value 
def __repr_ (self): 
return str(self.value) 


>>> a = A(10) + creaza o legatura 

>>> d = weakref.WeakValueDictionary () 

>>> d[’primary’] =a # nu creaza legatura 

>>> d[’primary’ ] # fetch the object if it is still alive 
10 

>>> dela # elimina o referinta 

>>> gc.collect () # activeaza "cosul de gunoi" 

0 

>>> d[’primary’ ] # intrarea a fost eliminata automat 


Traceback (most recent call last): 
File "<pyshell#108>", line 1, in -toplevel- 
d[’ primary’ ] # entry was automatically removed 
File "C:/PY24/lib/weakref.py", line 46, in __getitem__ 
o = self.data[key] () 
KeyError: ‘primary’ 


11.7 Instrumente de lucru cu listele 


Multe structuri de date se contruiesc cu ajutorul listelor predefinite.Oricum, uneori se impune necesitatea unei 
implementări alternative cu performanţe diferite de cele obişnuite. 


Modulul array oferă obiectul array () care se comporta ca o listă care cuprinde numai obiecte de acelaşi fel, 
dar care sunt stocate mai compact decât în cazul listei standard. În următorul exemplu se prezintă cum un array! de 
numere memorate ca numere binare făra semn reprezentate pe doi octeți (cod de tip "H") este contrapus utilizării 
unei liste standard de obiecte Python de tip int, reprezentate pe 16 octeți : 


>>> from array import array 

>>> a = array(’H’, [4000, 10, 700, 22222]) 
>>> sum(a) 

26932 

>>> a[1:3] 

array(’H’, [10, 700]) 


Modulul collection contine obiectul deque () care se aseamanaa cu tipul lista, cu adaugari si scoateri rapide 
de elemente prin stânga, dar cu o accesarea lentă a mijlocului.Aceste obiecte sunt convenabile pentru imple- 
mentarea cozilor şi a cautării pe nivel pentru arbori : 


l Array = Lista cu valori de acelaşi tip care se pot referi individual 
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>>> from collections import deque 

>>> d = deque(["task1", "task2", "task3"]) 
>>> d.append("task4") 

>>> print "Handling", d.popleft () 

Handling taskl 


unsearched = deque([starting_node] ) 
def breadth_first_search (unsearched) : 
node = unsearched.popleft () 
for m in gen_moves (node) : 
if is_goal(m): 
return m 
unsearched. append (m) 


Biblioteca oferă, tot pentru alternativa la implementarea cu liste, şi modulul bi sect cu funcţii pentru manipularea 
listelor sortate : 


>>> import bisect 

>>> scores = [(100, 'perl'), (200, ’tcl’), (400, ’lua’), (500, ‘python’ ) ] 
>>> bisect.insort (scores, (300, 'ruby')) 

>>> scores 

[(100, perl’), (200, tcl’), (300, ruby’), (400, ’lua’), (500, ‘’python’) ] 


Modulul heapg conţine funcţii pentru implementarea de heap ? utilizând listele standard. Valoarea intrării celei 
mai mici este ţinută permanent la poziţia zero. Acest lucru este util pentru aplicaţiile în care se accesează repetitiv 
elementul cel mai mic, dar nu se doreşte o sortare completă a listei: 


>>> from heapg import heapify, heappop, heappush 
>>> data = [1, 3, 5, 7, 9, 2, 4, 6, 8, 0] 


>>> heapify (data) + rearanjeaza lista in ordinea heap 
>>> heappush (data, -5) + se adauga o noua intrare 

>>> [heappop (data) for i in range(3)] + aduce cele mai mici trei intrari 
[=3:; 0, 1] 


11.8 Aritmetica în virgulă flotantă zecimală 


Modulul decimal oferă, pentru aritmetica în virgulă flotantă, tipul de data Decimal.Comparand-o cu clasa 
predefinită float, implementată pentru lucrul în virgulă flotantă binară, noua clasă este necesară în aplicaţiile 
financiare şi, în general, în aplicaţiile care necesită : o reprezentare zecimală exactă, o precizie ridicată, o rotunjire 
impusă foarte bună, poziţionarea zecimalelor semnificative. O altă întrebuințare ar fi pentru aplicaţiile în care 
utilizatorul doreşte confruntarea calculelor cu cele executate manual. 


De exemplu, calculând taxa de 5% pentru o convorbire telefonică de 70 de cenți, folosind aritmetica în virgulă 
flotantă zecimal şi cea binară se obţin rezultate diferite : 


2 Heap = porţiune de memorie rezervată pentru a fi utilizată de un program ca zonă de stocare temporară a unor structuri de date a căror 
mărime, sau existenţă nu se pot determina decât în timpul rulării programilui. 
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>>> from decimal import x 

>>> Decimal (70.707) * Decimal ('1.05') 
Decimal ("0.7350") 

>>> .70 x 1.05 

0.73499999999999999 


In exemplu, rezultatul funcţiei Decimal menţine la sfărşit un zero pentru ca partea zecimală să fie compusă din 


patru cifre. Astfel se simulează calculul făcut cu mâna, când înmultind doua numere, fiecare cu două zecimale se 


obţine la rezultat partea zecimală din patru cifre.In acest fel se evită situaţia care apare când aritmetica în virgulă 


flotantă binară nu reprezintă precis cantitatea zecimală. 


Pentru că returnează rezultatul exact clasa Decimal este folosită în calcule modulo şi în teste de egalitate, 


domenii pentru care aritmetica în virgulă flotantă binară nu este aplicabilă : 


>>> Decimal (71.007) $ Decimal(’.10’) 
Decimal ("0.00") 

>>> 1.00 $ 0.10 

0.09999999999999995 


>>> sum([Decimal(’0.1’)]*10) == Decimal ('1.0') 
True 

>>> sum([0.1]*10) == 1.0 

False 


Modulul Decimal poate executa calcule cu o precizie impusă de utilizator : 


>>> getcontext () .prec = 36 
>>> Decimal (1) / Decimal (7) 
Decimal ("0.142857142857142857142857142857142857") 
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CAPITOLUL 
DOISPREZECE 


Continuarea? 


Să sperăm că acest tutorial v-a trezit interesul în ceea ce priveşte limbajul Python. Ce ar trebui să faceţi de acum 
încolo? 


Ar trebui să citiţi, sau cel putin să rasfoiti Python Library Reference,document ce explică foarte detaliat fiecare 
funcţie, tip de date, modul, etc. existent în Python. Distribuţia standard de Python conţine o cantitate imensă de 
cod scris atât în C, cât şi în Python, există module UNIX ce pot fi folosite pentru a citi cásutele de posta electronica, 
module care facilitează lucrul cu protocolul HTTP, module pentru generarea numerelor aleatoare, etc. 


Un site foarte util este http: //www.python.org. Aici există documentatii bucăţi de cod scrise de alţi pro- 
gramatori şi link-uri legate de Python. 


Copii ale acestui site există pe serverele din întreaga lume (Europa, Australia, Japonia, etc). În funcţie de locul 
în care vă aflaţi, pentru o viteză de acces mai mare, puteţi folosi una dintre aceste copii. Un alt site ce se poate 
dovedi foarte util este http: //starship.python.net. 


Pentru întrebări sau raportarea anumitor probleme puteţi folosi grupul comp.lang.python, sau puteţi scrie la 
Python-list@python.org. În fiecare zi sunt puse în jur de 120 de întrebări care, de obicei, îşi găsesc răspunsul. 


Înainte de a pune o întrebare, verificaţi lista întrebărilor puse frecvent (Freqvently Asked Questions = FAQ) care 
poate fi găsită la adresa ht tp: //www.python.org/doc/fag.html. Răspunsurile de la această adresă, la 
diferite întrebări puse de alti programatori, vă pot ajuta de foarte multe ori în rezolvarea problemelor dumneav- 
oastră. 
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ANEXA 


Editarea în linie de comanda şi repetarea 
comenzilor anterioare 


Unele versiuni ale interpretorului Python suportă editarea în linie de comandă şi repetarea unor comenzi anterioare, 


EG 


Readline care suportá stilurile de editare specifice Emacs si Vi. Aceastá bibliotecá are propria documentafie pe 
care nu o vom reproduce aici, ci vom face numai o scurtá introducere. 


Facilitátile despre care vá vom vorbi sunt disponibile ín versiunile UNIX si CygWin ale interpretorului. 


Acest capitol nu va explica facilităţile pachetelor Mark Hammond’s Python Win sau IDLE distribuite odată cu 
Python. 


A.1 Editarea în linie de comandă 


Dacă este suportată, această facilitate va fi disponibilă atunci când interpretorul afişează promptul principal sau 
cel secundar. 


Linia curentă poate fi editată folosind caracterele de control convenţionale Emacs. 


Cele mai importante sunt: 


C-A(Control-A) mută cursorul la începutul liniei; 


C-E(Control-E) mută cursorul la sfârşitul liniei; 


C-B mută cursorul cu o poziţie la stânga; 


C-F mută cursorul cu o poziţie la dreapta; 


BACKSPACE şterge caracterul de la stânga cursorului; 


C-D şterge caracterul de la dreapta cursorului; 


C-K şterge tot ce urmeză pe linie în dreapta cursorului; 


C-Y reface ultimul şir şters cu C-K; 


C-_ anulează ultima comandă efectuată. Operația poate fi repetată. 


A.2 Repetarea comenzilor anterioare(History) 


Toate comenzile executate sunt salvate într-o zonă tampon (Buffer). Atunci când este executată o nouă instrucţiune 
aceasta este salvată la sfârşitul buffer-ului. 


C-P revine la o comandă anterioară în buffer celei executate. 


C-M înaintează la următoarea instrucţiune din buffer. 
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Orice linie din buffer poate fi modificată. Dacă o linie a fost modificată veţi vedea un caracter **” în fata acesteia 
care îndică că a fost modificată. O instrucţiune din buffer este executată dacă se apasă, evident, ENTER. 


C-R porneşte o căutare incrementală în buffer în sens invers. 


C-S porneşte o căutare în sens normal. 


A.3  Redefinirea tastelor funcţionale 


Tastele funcţionale şi alţi parametrii ai bibliotecii “Readline”, pot fi redefiniti prin modificarea fişierului 
“/.inputre”. Pentru a redefini funcţia unei combinaţii de taste trebuie folosită sintaxa: 


tastă:funcţie sau “sir de caractere”:functie. 
O opţiune poate fi setată folosind 

set opţiune valoarenouă. 
Iată un exemplu: 


+ Prefer stil de editare Vi: 
set editing-mode vi 

+ Editare pe o singura linie: 
set horizontal-scroll-mode On 
+ Redefinesc cateva taste: 
Meta-h: backward-kill-word 
"\C-u": universal-argument 
"\C-x\C-r": re-read-init-fil 


În Python principala funcţie pentru Tab este aceea de a insera Tab, nu funcţia de completare Readline. Dacă se 
doreşte însă utilizarea sa în funcţia de completare se va pune : 


Tab: complete 


în “/.inputrc”. (Bine înţeles că acum va fi mai dificil de a scrie spaţiile de aliniere) 


Completarea automată a numelui unei variabile, sau a unui modul, este opţională. Pentru a o activa în modul de 
lucru interactiv adáugat în fişierul de startup următoarele :! 


import rlcompleter, readline 
readline.parse_and_bind(’tab: complete’) 


Aceasta leagă tasta Tab de funcţia de completare, deci apăsând tasta Tab de doua ori activează completarea; anal- 
izează numele instrucţiunii Python, variabilele locale curente şi numele de module disponibile.Pentru expresiile 
cu punct de tipul string.a, evaluează expresia până la final, după *.” şi apoi sugerează completarea dată de 
atributele obiectelor rezultate. De reţinut că se poate executa codul unei aplicaţii definite dacă un obiect ce are 
metoda__ get at tr___() face parte din expresie. 


Un fişier startup mai cuprinzător poate arăta ca in exemplul următor. De notat că el işi sterge numele pe care 
le crează în momentul în care nu-i mai sunt necesare. Acest lucru se petrece când fişierul de starup se execută 
în acelaşi domeniu de definiţie ca şi comenzile interactive, iar eliminarea numelor evită generarea unor efecte 
colaterale în mediul interactiv. Puteţi găsi acest lucru convenabil pentru a păstra câteva module importate, cum ar 
fi os, şi care se dovedesc necesare în majoritatea sesiunilor interpretorului. 


l Python va executa conţinutul unui fişier identificat prin variabila de mediu PYTHONSTARTUP în momentul pornirii interpretorului 
interactiv. 
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La interpretorul interactiv Python se adauga functia de autocompletare 
si un fisier de tip jurnal pentru comenzi. Se cere Python 2.0+, 
readline. Autocompletarea este executata implicit prin tasta Esc (dar, 
tasta poate fi inlocuita - vezi documentatia readline). 


Puneti fisierul in ~/.pystartup, iar variabila de mediu sa-l 
indice, cum ar fi in bash "export PYTHONSTARTUP=/max/home/itamar/.pystartup". 


Retineti ca PYTHONSTARTUP nu expandeaza "~", deci va trebui 
indicata intraga cale a directorului home 


de de de Sk de de de e Se e 


import atexit 
import os 

import readline 
import rlcompleter 


historyPath = os.path.expanduser ("-/.pyhistory") 


def save_history(historyPath=historyPath): 
import readline 
readline.write_history_file(historyPath) 


if os.path.exists (historyPath): 
readline.read history_file(historyPath) 


atexit.register (save_history) 
del os, atexit, readline, rlcompleter, save _history, historyPath 


A.4 Comentarii 


Aceste facilităţi reprezintă un pas enorm comparativ cu versiunile anterioare ale interpretorului; oricum au rămas 
câteva deziderate neâmplinite : ar fi frumos ca să fie sugerat un alineat corect la continuarea unei linii (analizorul 
sintactic ştie dacâ se va cere un alineat). Acest nou mecanism ar putea utiliza tabela de simboluri a interpretorului. 
Util ar fi şi un mecanism care să verifice (sau să sugereze) potrivirea parantezelor, ghilimelelor, etc. 
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ANEXA 


Aritmetica în virgulă flotantă: rezultate şi 
limitări 


Numerele în virgulă flotantă sunt reprezentate în hardware-ul calculatorului ca fracţii în baza 2 (binare). De 
exemplu, fractia zecimală 


05125 


are valoarea 1/10 + 2/100 + 5/1000, şi în acelaşi fel fractia binară 


0.001 


are valoarea 0/2 + 0/4 + 1/8. Aceste două fracţii au aceeaşi valoare, singura diferenţă reală fiind că prima este 
scrisă în baza 10, iar a doua în baza 2. Din păcate majoritatea fractiilor zecimale nu pot fi reprezentate corect ca 
fracţii binare. O primă concluzie este că, (în general, numerele în virgulă flotantă zecimală pe care le introduceţi 
au numai o reprezentare aproximativă prin numerele în virgulă flotantá binară memorate în calculator. 


Problema este uşor de înţeles inti în baza 10. Să considerăm fractia 1/3. O putet aproxima cu o fractie î baza 10: 


0.3 


sau, mai precis, 


0.33 


sau ,si mai precis, 


0.333 


şi tot aşa. Nu contează ce număr de digiti veţi scrie, rezultatul nu va fi nicicâd exact 1/3, dar creşte acurateţea 
aproximării lui 1/3. 


În acelaşi mod, nu contează câti digiti în baza 2 folosiţi, valoarea zecimală 0.1 nu va fi reprezentată exact niciodată 
printr-o fractie. In baza 2, 1/10 este o fractie care se repetă la infinit 


0.0001100110011001100110011001100110011001100110011... 


Oprirea la un număr finit de biti dă o aproximare. Iată ce se afişează in situaţia următoare : 


>>> 0.1 
0.10000000000000001 


Pe majoritatea maşinilor existente astăzi acest rezultat se afişează dacă introduceţi 0.1 la prompterului Python-ului. 
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Se întâmplă aşa pentru că numărul de biţi utilizaţi de hardware să mememoreze valoarea în virgulă flotantă variază 
de la o maşină la alta, iar Python listează doar o aproximaţie zecimală a valorii zecimale reale a aproximatiei binare 
memorată în maşină. Pe majoritatea maşinilor, dacă Python va tipări valoarea zecimală reală a aproximatiei binare 
memorate pentru 0.1, va afişa 


>>> 0.1 
0.1000000000000000055511151231257827021181583404541015625 


Prompterul Python utilizează funcția implicită repr () ca să obțină o versiune de şir pentru toate obiectele pe 
care le afişează. In cazul numerele flotante repr (float) rotunjeşte valoarea zecimală la 17 digiti semnificativi, 
astfel 


0.10000000000000001 


repr (float) foloseşte 17 biți semnificativi pentru că sunt considerați suficienți pe majoritatea maşinilor, aşa că 
relaţia eval (repr (x)) == x este exactă pentru toate numerele flotante finite x, dar rotunjirea la 16 biti nu 
este suficientă pentru a face relația adevărată. 


Acesta este un lucru normal al aritmeticii binare în virgulă flotantă : nu este un bug Python, nici un bug al codului 
dumneavoastră şi veți constata o astfel de anomalie în toate limbajele care folosesc aritmetica în virgulă flotantă 
oferită de hardware (unele limbaje pot să nu afișeze implicit diferenţa) 


Funcţia internă Python str () generează numai 12 digiti semnificativi şi poate că doriţi să o folosiţi modificată. 
Este des utilizată funcţia eval (str (x) ) pentru a-l obţine pe x, dar este mai placut să se afişeze : 


>>> print str(0.1) 
0.1 


E bine de ştiut că, în sens real, este o iluzie : în maşină valoarea nu este exact 1/10, valoarea adevărată din maşină 
este rotunjită la afişare. 


Această surpriză este urmata de altele. De exemplu după ce se afişează 


>>> 0.1 
0.10000000000000001 


apare tentatia să utilizaţi funcţia round () ca să trunchiati iarăşi la un digit. Dar aceasta nu face nimic: 


>>> round(0.1, 1) 
0.10000000000000001 


Problema este că valoarea memorată învirgulă flotanta binară pentru "0.1" a fost făcută în cea mai bună aproximare 
binară posibilă la 1/10, deci orice altă rotunjire ulterioară nu o poate face mai bine : a fost dată deja cea mai bună 
soluţie. 


Altă consecinţă a faptului că 0.1 nu este exact 1/10 este aceea că adăugând la 0.1 pe el însuşi de 10 ori nu se obţine 
1.0: 


>>> sum = 0.0 

>>> for i in range(10): 
sum += 0.1 

fs>>> sum 

0.99999999999999989 
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Aritmetica binară în virgulă flotantá are multe surprize de acest gen. Problema cu "0.1" este explicată în secţiunea 
următoare, "Erori de reprezentare". Vezi : The Perils of Floating Point privind tratarea completă a altor surprize 
de acest gen. 


Cum s-ar spune la sfârşit: "nu este uşor de răspuns”. Totuşi nu disperaţi din cauza virgulei flotante! Erorile 
operaţiilor de flotantă din Python sunt moştenite de la virgula flotanta a hardware-ului şi la majoritatea maşinilor 
sunt de un ordin mai mic de 1/2**53 pe operaţie. Acestea sunt mai mult decât acceptabile pentru cele mai multe 
aplicaţii, dar trebuie să retineti că nu sunt datorate aritmeticii zecimale şi că la fiecare operaţie învirgulă flotanta 
apare o eroare de rotunjire. 


Până la apariţia unor cazuri patologice, pentru cele mai multe situaţii de utilizare a aritmeticii învirgulă flotanta 
se obţin rezultatele aşteptate, dacă pur şi simplu se rotunjeşte rezultatul final afişat la numărul de zecimale dorit. 
Uzual funcţia str () este suficientă, iar pentru un control mai riguros a se vedea discuţia despre operatorul de 
format $ : formatele %g, $f şi Se sunt moduri flexibile şi uşoare pentru afişarea rezultatelor. 


B.1 Erori de reprezentare 


Secţiunea explică îndetaliu exemplul "0.1" şi arată cum se poate face o analiză exactă a cazurilor. In principal se 
urmăreşte familiarizarea cu reprezentarea binară în virgulă floantă. 


Eroarea de reprezentare se referă la faptul că fracțiile zecimale nu se pot reprezenta exact ca fracţii binare (in 
baza 2). Acesta este motivul major pentru care Python (sau Perl, C, C++,Java, Fortran, şi multe altele) nu afişează 
valoarea exactă a numărului zecimal pe care-l aşteptaţi : 


>>> 0.1 
0.10000000000000001 


Ce este asta ? 1/10 nu este reprezentat exact ca o fractie binară. Cele mai multe maşini utilizează astăzi (noiembrie 
2000) aritmetica de virgulă flotantá IEEE-754 şi cele mai multe platforme mapează flotantele Python in"dubla 
precizie" IEEE-754. Dublele 754 au 53 biţi de precizie. Aşa că la intrarea în calculator se chinuie să convertească 
0.1 încea mai apropiată fractie posibilă de forma J/2**N, unde J este un întreg de exact 53 de biti. Se rescrie 


1 / 10 ~= J / (2*«N) 


ca 


J ~= 2xxN / 10 


şi reapeland J are exact 53 de biti (este >= 2**52 dar < 2xx53), şi cea mai bună valoare pentru N este 56: 


>>> 21xx52 
4503599627370496L 
>>> 2Lxx53 
9007199254740992L 
>>> 2Lxx56/10 
7205759403792793L 


Asta este, 56 este singura valoare pentru N care lasă J cu exact 53 de biti. Atunci cea mai bună valoare posibilă 
pentru J este câtul rotunjit: 


B.1. Erori de reprezentare 91 


>>> q, r = divmod(2Lx*x*56, 10) 
>>> r 
6L 


După ce restul este mai mare decît jumătatea lui 10, cea mai bună aproximaţie se obţine prin rotunjirea: 


>>> q+1 
7205759403792794L 


Astfel cea mai bună aproximaţie a lui 1/10, în dubla precizie 754, este peste 2**56, sau 


7205759403792794 / 72057594037927936 


De remarcat cá páná la rotunjire, valoarea este de fapt un pic mai mare decát 1/10; dacá nu am rotunji cátul va fi 
un pic mai mic decît 1/10. Dar în nici un caz nu poate fi exact 1/10! 


Deci, niciodata computerul nu va “aráta” 1/10: ce va aráta este exact fractia datá mai jos, cea mai buná aproximatie 
in 754 care poate fi datá: 


>>> .1 x 2Lxx56 
7205759403792794.0 


Dacă se inmulteste fractia cu 10**30, vom vedea valoarea (truncheatá) a celor mai semnificativi 30 de digiti 
zecimali ai săi: 


>>> 7205759403792794L * 10L**30 / 2Lx*x*56 
100000000000000005551115123125L 


însemnând ca numărul exact memorat in calculator este aproximativ egal cu valoarea zecimală 
0.100000000000000005551115123125. Rotunjind la 17 digiti semnificativi rezultă 0.100000000000000001 pe 
care Python îl afişează (va afişa pe orice platformă conformă 754 care va face tot posibilul să convertească intrare 
şi ieşire prin biblioteca C proprie — al dumneavoastră s-ar putea să nu reuşească acest lucru!) 
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ANEXA 


Istoricul produsului Python şi licențierea 


C.1 Istoricul produsului 


Python a fost creat la începutul anilor 1990 de către Guido van Rossum la Stichting Mathematisch Centrum (CWI, 
vezi http: //www.cwi.n1/) din Olanda, ca succesor al limbajului ABC. Guido a rămas principalul autor al 
Python-ului, care acumulează multe contribuţii ale altora. 


În 1995 Guido işi continuă munca la Python la Corporation for National Research Initiatives (CNRI, vezi http: 
//www.cnri.reston.va.us/) în Reston, Virginia, unde a lansat câteva versiuni ale software-ului. 


În mai 2000, Guido şi echipa de dezvoltare a Python-ului s-a mutat la BeOpen.com, unde a format echipa BeOpen 
PythonLabs. Î octombrie 2000, colectivul PythonLabs s-a mutat la Digital Creations (acum Zope Corporation ; 
vezi http: //www.zope. com/).1n 2001 ia naştere Python Software Foundation (PSF, vezi http://www. 
python.org/psf/) o organizaţie non profit creată special pentru a detne drepturile de autor! referitoare la 
Python. Zope Corporation este unul din sponsorii PSF. 


Toate lansările pe piaţă (versiunile) Python sunt Open Source (vezi http: //www.opensource.org/ pentru 
a găsi definiţia Open Source ). Istoriceşte vorbind cele mai multe dintre lansările Python, nu toate, sunt de 
asemenea compatibile GPL(General Public License). Tabelul următor face un sumar al diferitelor lansări. 


Release Derived from Year Owner GPL compatible? 
0.9.0 thru 1.2 n/a 1991-1995 CWI yes 
1.3 thru 1.5.2 1.2 1995-1999 CNRI yes 

1.6 1.5.2 2000 CNRI no 
2.0 1.6 2000 BeOpen.com no 
1.6.1 1.6 2001 CNRI no 
2.1 2.0+1.6.1 2001 PSF no 
2.0.1 2.0+1.6.1 2001 PSF yes 
2.1.1 2.1+2.0.1 2001 PSF yes 
2.2 2.1.1 2001 PSF yes 
212 2.1.1 2002 PSF yes 
2.1.3 2.1.2 2002 PSF yes 
2.2.1 2.2 2002 PSF yes 
2.2.2 2.2.1 2002 PSF yes 
2.2.3 2.2.2 2002-2003 PSF yes 
2.3 2.2.2 2002-2003 PSF yes 
2.3.1 2.3 2002-2003 PSF yes 
23.2 2.3.1 2003 PSF yes 
2.3.3 2.3.2 2003 PSF yes 
2.3.4 2.3.3 2004 PSF yes 
2.3.5 2.3.4 2005 PSF yes 
2.4 2.3 2004 PSF yes 
2.4.1 2.4 2005 PSF yes 


Notă: Compatibil GPL nu înseamnă că Python este distribuit sub GPL. Toate licenţele Python, spre deosebire de 
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GPL, iti permit să distribui o versiune modificată fără a-ţi face şi modificările “open source”. Licentele compatibile 
GPL fac posibilă combinarea Pyton-ului cu alte software care au apărut sub GPL; celelate neputând face acest 
lucru. 


Mulţumim numeroşilor voluntari din exteriorul echipei, care lucrând sub coordonarea lui Guido, au contribuit la 
apariţia acestor versiuni. 


C.2 Terms and conditions for accessing or otherwise using Python 


PSF LICENSE AGREEMENT FOR PYTHON 2.4.1 


1. This LICENSE AGREEMENT is between the Python Software Foundation (“PSF”), and the Individual or 
Organization (“Licensee”) accessing and otherwise using Python 2.4.1 software in source or binary form 
and its associated documentation. 


2. Subject to the terms and conditions of this License Agreement, PSF hereby grants Licensee a nonexclusive, 
royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare deriva- 
tive works, distribute, and otherwise use Python 2.4.1 alone or in any derivative version, provided, however, 
that PSF’s License Agreement and PSF's notice of copyright, i.e., “Copyright © 2001-2004 Python Software 
Foundation; All Rights Reserved” are retained in Python 2.4.1 alone or in any derivative version prepared 
by Licensee. 


3. In the event Licensee prepares a derivative work that is based on or incorporates Python 2.4.1 or any part 
thereof, and wants to make the derivative work available to others as provided herein, then Licensee hereby 
agrees to include in any such work a brief summary of the changes made to Python 2.4.1. 


4. PSF is making Python 2.4.1 available to Licensee on an “AS IS” basis. PSF MAKES NO REPRESEN- 
TATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMI- 
TATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MER- 
CHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 
2.4.1 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 


5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 2.4.1 FOR ANY 
INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF MODIFY- 
ING, DISTRIBUTING, OR OTHERWISE USING PYTHON 2.4.1, OR ANY DERIVATIVE THEREOF, 
EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 


6. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 


7. Nothing in this License Agreement shall be deemed to create any relationship of agency, partnership, or 
joint venture between PSF and Licensee. This License Agreement does not grant permission to use PSF 
trademarks or trade name in a trademark sense to endorse or promote products or services of Licensee, or 
any third party. 


8. By copying, installing or otherwise using Python 2.4.1, Licensee agrees to be bound by the terms and 
conditions of this License Agreement. 


BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 
BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 


1. This LICENSE AGREEMENT is between BeOpen.com (“BeOpen”), having an office at 160 Saratoga 
Avenue, Santa Clara, CA 95051, and the Individual or Organization (“Licensee”) accessing and otherwise 
using this software in source or binary form and its associated documentation (“the Software”). 


2. Subject to the terms and conditions of this BeOpen Python License Agreement, BeOpen hereby grants Li- 
censee a non-exclusive, royalty-free, world-wide license to reproduce, analyze, test, perform and/or display 
publicly, prepare derivative works, distribute, and otherwise use the Software alone or in any derivative 
version, provided, however, that the BeOpen Python License is retained in the Software, alone or in any 
derivative version prepared by Licensee. 


94 Anexa C. Istoricul produsului Python şi licentierea 
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. BeOpen is making the Software available to Licensee on an “AS IS” basis. BEOPEN MAKES NO REP- 


RESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT 
LIMITATION, BEOPEN MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY 
OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF 
THE SOFTWARE WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 


. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE SOFTWARE 


FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT 
OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY DERIVATIVE THEREOF, 
EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 


. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 


. This License Agreement shall be governed by and interpreted in all respects by the law of the State of 


California, excluding conflict of law provisions. Nothing in this License Agreement shall be deemed to 
create any relationship of agency, partnership, or joint venture between BeOpen and Licensee. This License 
Agreement does not grant permission to use BeOpen trademarks or trade names in a trademark sense to 
endorse or promote products or services of Licensee, or any third party. As an exception, the “BeOpen 
Python” logos available at http://www.pythonlabs.com/logos.html may be used according to the permissions 
granted on that web page. 


. By copying, installing or otherwise using the software, Licensee agrees to be bound by the terms and 


conditions of this License Agreement. 


CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 


. This LICENSE AGREEMENT is between the Corporation for National Research Initiatives, having an 


office at 1895 Preston White Drive, Reston, VA 20191 (“CNRI”), and the Individual or Organization (“Li- 
censee”) accessing and otherwise using Python 1.6.1 software in source or binary form and its associated 
documentation. 


„ Subject to the terms and conditions of this License Agreement, CNRI hereby grants Licensee a nonexclu- 


sive, royalty-free, world-wide license to reproduce, analyze, test, perform and/or display publicly, prepare 
derivative works, distribute, and otherwise use Python 1.6.1 alone or in any derivative version, provided, 
however, that CNRI’s License Agreement and CNRI’s notice of copyright, i.e., “Copyright O 1995-2001 
Corporation for National Research Initiatives; All Rights Reserved” are retained in Python 1.6.1 alone 
or in any derivative version prepared by Licensee. Alternately, in lieu of CNRI's License Agreement, 
Licensee may substitute the following text (omitting the quotes): “Python 1.6.1 is made available sub- 
ject to the terms and conditions in CNRI's License Agreement. This Agreement together with Python 
1.6.1 may be located on the Internet using the following unique, persistent identifier (known as a handle): 
1895.22/1013. This Agreement may also be obtained from a proxy server on the Internet using the following 
URL: http: //hdl.handle.net/1895.22/1013.” 


. In the event Licensee prepares a derivative work that is based on or incorporates Python 1.6.1 or any part 


thereof, and wants to make the derivative work available to others as provided herein, then Licensee hereby 
agrees to include in any such work a brief summary of the changes made to Python 1.6.1. 


. CNRI is making Python 1.6.1 available to Licensee on an “AS IS” basis. CNRI MAKES NO REPRESEN- 


TATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMI- 
TATION, CNRI MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MER- 
CHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 
1.6.1 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS. 


. CNRISHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 1.6.1 FOR ANY 


INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF MODIFY- 
ING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, OR ANY DERIVATIVE THEREOF, 
EVEN IF ADVISED OF THE POSSIBILITY THEREOF. 


. This License Agreement will automatically terminate upon a material breach of its terms and conditions. 
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7. This License Agreement shall be governed by the federal intellectual property law of the United States, in- 
cluding without limitation the federal copyright law, and, to the extent such U.S. federal law does not apply, 
by the law of the Commonwealth of Virginia, excluding Virginia’s conflict of law provisions. Notwithstand- 
ing the foregoing, with regard to derivative works based on Python 1.6.1 that incorporate non-separable 
material that was previously distributed under the GNU General Public License (GPL), the law of the Com- 
monwealth of Virginia shall govern this License Agreement only as to issues arising under or with respect 
to Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this License Agreement shall be deemed to 
create any relationship of agency, partnership, or joint venture between CNRI and Licensee. This License 
Agreement does not grant permission to use CNRI trademarks or trade name in a trademark sense to endorse 
or promote products or services of Licensee, or any third party. 


8. By clicking on the “ACCEPT” button where indicated, or by copying, installing or otherwise using Python 
1.6.1, Licensee agrees to be bound by the terms and conditions of this License Agreement. 


ACCEPT 
CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 


Copyright © 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, The Netherlands. All rights reserved. 


Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee 
is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice 
and this permission notice appear in supporting documentation, and that the name of Stichting Mathematisch 
Centrum or CWI not be used in advertising or publicity pertaining to distribution of the software without specific, 
written prior permission. 


STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS 
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO 
EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE FOR ANY SPECIAL, INDIRECT 
OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF 
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TOR- 
TIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
SOFTWARE. 


C.3 Licenses and Acknowledgements for Incorporated Software 


This section is an incomplete, but growing list of licenses and acknowledgements for third-party software incor- 
porated in the Python distribution. 


C.3.1 Mersenne Twister 


The _random module includes code based on a download from http: //www.math.keio.ac.J3p/ 
~matumoto/MT2002/emt19937ar.html. The following are the verbatim comments from the original 
code: 
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A C-program for MT19937, with initialization improved 2002/1/26. 
Coded by Takuji Nishimura and Makoto Matsumoto. 


Before using, initialize the state by using init_genrand (seed) 
or init_by_array(init_key, key_length). 


Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura, 
All rights reserved. 


Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions 
are met: 


1. Redistributions of source code must retain the above copyright 
notice, this list of conditions and the following disclaimer. 


2. Redistributions in binary form must reproduce the above copyright 
notice, this list of conditions and the following disclaimer in the 
documentation and/or other materials provided with the distribution. 


3. The names of its contributors may not be used to endorse or promote 
products derived from this software without specific prior written 
permission. 


THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 

PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 


Any feedback is very welcome. 
http: //www.math.keio.ac.Jp/matumoto/emt.html 
email: matumoto@math.keio.ac.jp 


C.3.2 Sockets 


The socket module uses the functions, getaddrinfo, and getnameinfo, which are coded in separate 
source files from the WIDE Project, http: //www.wide.ad. jp/about/index.html. 
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Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. 
All rights reserved. 


Redistribution and use in source and binary forms, with or without 

modification, are permitted provided that the following conditions 

are met: 

1. Redistributions of source code must retain the above copyright 
notice, this list of conditions and the following disclaimer. 

2. Redistributions in binary form must reproduce the above copyright 
notice, this list of conditions and the following disclaimer in the 
documentation and/or other materials provided with the distribution. 

3. Neither the name of the project nor the names of its contributors 
may be used to endorse or promote products derived from this software 
without specific prior written permission. 


THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS "AS IS’’ AND 

GAI_ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOS 
ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE 
FOR GAI_ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
O 
H 
L 
O 
S 


El 


T 


2 


AM 

R SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
OWEVER CAUSED AND ON GAI_ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
IABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN GAI_ANY WAY 
UT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 

UCH DAMAGE. 


C.3.3 Floating point exception control 


The source for the fpect 1 module includes the following notice: 
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/ Copyright (c) 1996. 
The Regents of the University of California. 
All rights reserved. 


| Permission to use, copy, modify, and distribute this software for 
any purpose without fee is hereby granted, provided that this en- 
tire notice is included in all copies of any software which is or 
| includes a copy or modification of this software and in all 
copies of the supporting documentation for such software. 


This work was produced at the University of California, Lawrence 
| Livermore National Laboratory under contract no. W-7405-ENG-48 
between the U.S. Department of Energy and The Regents of the 
University of California for the operation of UC LLNL. 


DISCLAIM 


q 


R 


This software was prepared as an account of work sponsored by an 
agency of the United States Government. Neither the United States 
Government nor the University of California nor any of their em- 
ployees, makes any warranty, express or implied, or assumes any 
liability or responsibility for the accuracy, completeness, or 
usefulness of any information, apparatus, product, or process 
disclosed, or represents that its use would not infringe 
privately-owned rights. Reference herein to any specific commer- 
| cial products, process, or service by trade name, trademark, 
manufacturer, or otherwise, does not necessarily constitute or 
imply its endorsement, recommendation, or favoring by the United 
States Government or the University of California. The views and 
opinions of authors expressed herein do not necessarily state or 
reflect those of the United States Government or the University 
| of California, and shall not be used for advertising or product 
\ endorsement purposes. 


C.3.4 MD5 message digest algorithm 


The source code for the md5 module contains the following notice: 
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Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All 
rights reserved. 


License to copy and use this software is granted provided that it 
is identified as the "RSA Data Security, Inc. MD5 Message-Digest 
Algorithm" in all material mentioning or referencing this software 
or this function. 


License is also granted to make and use derivative works provided 
that such works are identified as "derived from the RSA Data 
Security, Inc. MD5 Message-Digest Algorithm" in all material 
mentioning or referencing the derived work. 


RSA Data Security, Inc. makes no representations concerning either 
the merchantability of this software or the suitability of this 
software for any particular purpose. It is provided "as is" 
without express or implied warranty of any kind. 


These notices must be retained in any copies of any part of this 
documentation and/or software. 


C.3.5 Asynchronous socket services 


The asynchat and asyncore modules contain the following notice: 


Copyright 1996 by Sam Rushing 
All Rights Reserved 


Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby 
granted, provided that the above copyright notice appear in all 
copies and that both that copyright notice and this permission 
notice appear in supporting documentation, and that the name of Sam 
Rushing not be used in advertising or publicity pertaining to 
distribution of the software without specific, written prior 
permission. 


SAM RUSHING DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN 
NO EVENT SHALL SAM RUSHING BE LIABLE FOR ANY SPECIAL, INDIRECT OR 
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS 
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, 
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN 
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 


E 


C.3.6 Cookie management 


The Cookie module contains the following notice: 
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Copyright 2000 by Timothy O’Malley <timo@alum.mit.edu> 


All Rights Reserved 


Permission to use, copy, modify, and distribute this software 

and its documentation for any purpose and without fee is hereby 
granted, provided that the above copyright notice appear in all 
copies and that both that copyright notice and this permission 
notice appear in supporting documentation, and that the name of 
Timothy O’Malley not be used in advertising or publicity 

pertaining to distribution of the software without specific, written 
prior permission. 


Timothy O’Malley DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS 
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 
AND FITNESS, IN NO EVENT SHALL Timothy O’Malley BE LIABLE FOR 
ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS 
ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 
PERFORMANCE OF THIS SOFTWARE. 


C.3.7 Profiling 


The profile and pstats modules contain the following notice: 


Copyright 1994, by InfoSeek Corporation, all rights reserved. 
Written by James Roskind 


Permission to use, copy, modify, and distribute this Python software 
and its associated documentation for any purpose (subject to the 
restriction in the following sentence) without fee is hereby granted, 
provided that the above copyright notice appears in all copies, and 
that both that copyright notice and this permission notice appear in 
supporting documentation, and that the name of InfoSeek not be used in 
advertising or publicity pertaining to distribution of the software 
without specific, written prior permission. This permission is 
explicitly restricted to the copying and modification of the software 
to remain in Python, compiled Python, or other languages (such as C) 
wherein the modified or derived code is exclusively imported into a 
Python module. 


INFOSEEK CORPORATION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS 
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS. IN NO EVENT SHALL INFOSEEK CORPORATION BE LIABLE FOR ANY 
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER 
RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF 
CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN 
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 


E 


C.3.8 Execution tracing 


The trace module contains the following notice: 
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C.3.9 


portions copyright 2001, Auto 
err... 
Python 2.2 license. 

Author: Zooko O’Whielacronx 
http://zooko.com/ 


mailto: zooko@zooko.com 


Copyright 2000, Mojam Media, 
Author: Skip Montanaro 
Copyright 1999, Bioreason, In 
Author: Andrew Dalke 
Copyright 1995-1997, Automatr 
Author: Skip Montanaro 
Copyright 1991-1995, Stichtin 


Permission to use, copy, modi 
its associated documentation 
granted, provided that the ab 
and that both that copyright 
supporting documentation, and 
Bioreason or Mojam Media be u 


distribution of the software without specific, 


nomous Zones Industries, Inc., all rights... 


reserved and offered to the public under the terms of the 


Inc., all rights reserved. 


c., all rights reserved. 


ix, Inc., all rights reserved. 


g Mathematisch Centrum, all rights reserved. 


fy, and distribute this Python software and 
for any purpose without fee is hereby 

ove copyright notice appears in all copies, 
notice and this permission notice appear in 
that the name of neither Automatrix, 

sed in advertising or publicity pertaining to 
written prior permission. 


UUencode and UUdecode functions 


The uu module contains the following notice: 


Ellin 


Copyright 1994 by Lance 
Cathedral City, 

All Ri 
Permission to use, copy, modi 
documentation for any purpose 
provided that the above copyr 
both that copyright notice an 
supporting documentation, and 
not be used in advertising or 
of the software without speci 
LANCE ELLINGHOUSE DISCLAIMS A 


California Republic, 


ghouse 
United States of America. 
ghts Reserved 

fy, and distribute this software and its 
and without fee is hereby granted, 

ight notice appear in all copies and that 
d this permission notice appear in 

that the name of Lance Ellinghouse 
publicity pertaining to distribution 
fic, written prior permission. 
iL WARRANTIES WITH REGARD TO 


THIS SOFTWARI INCLUDING ALL 
FITNESS, IN NO EVENT SHALL 


By 


LANCE EL 


IMPLIED WARRANTIES OF MERCHANTABILITY AND 
LINGHOUSE CENTRUM BE LIABLE 


E 


OR 
LOS 


FOR ANY SPECIAL, INDIRECT 
WHATSOEVER RESULTING FROM 


CONS 
S OF 


T 


EQUENTIAL DAMAGES OR ANY DAMAGES 
USE, DATA OR PROFITS, WHETHER IN AN 


ACTION OF CONTRACT, NEGLIGENC 


E OR 


OTHER TORTIOUS ACTION, ARISING OUT 
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OF OR IN CONNECTION WITH T 


HE 


USE OR PERFORMANCE OF THIS SOFTWARE. 


Modified by Jack Jansen, CWI, 
Use binascii module to do t 
between ascii and binary. T 
version is still 5 times fa 


Arguments more compliant wi 


July 1995: 

he actual line-by-line conversion 
his results in a 1000-fold speedup. 
ster, though. 
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C.3.10 XML Remote Procedure Calls 


The xml rpclib module contains the following notice: 


The XML-RPC client interface is 


Copyright (c) 1999-2002 by Secret Labs AB 
Copyright (c) 1999-2002 by Fredrik Lundh 


By obtaining, using, and/or copying this software and/or its 
associated documentation, you agree that you have read, understood, 
and will comply with the following terms and conditions: 


Permission to use, copy, modify, and distribute this software and 
its associated documentation for any purpose and without fee is 
hereby granted, provided that the above copyright notice appears in 
all copies, and that both that copyright notice and this permission 
notice appear in supporting documentation, and that the name of 
Secret Labs AB or the author not be used in advertising or publicity 
pertaining to distribution of the software without specific, written 
prior permission. 


SECRE ABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD 
TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- 
ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR 


BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY 
DAMAGES WHATSOEVER RESULTING FROM LOSS OF US! DATA OR PROFITS, 
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE R OTHER TORTIOUS 
ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCI 
OF THIS SOFTWARE. 


E 


Ho: 


T 
E 
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